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PREFACE 



MANUAL OBJECTIVES 

This manual describes the VAX-11 MACRO language: the features that 
are in the language and the format and function of each feature. The 
VAX-11 MACRO User's Guide describes how to use VAX-11 MACRO. 

INTENDED AUDIENCE 

This manual is intended for all programmers writing VAX-11 MACRO 

programs. Programmers should be familiar with assembly language 

programming, the VAX-11 instruction set, and the VAX/VMS operating 
system before reading this manual. 

The VAX-11 MACRO User's Guide provides a brief introduction to the 
assembler and describes the commands necessary to use VAX-11 MACRO. 
The VAX-11/780 Architecture Handbook describes the VAX-11/780 
instruction set. All programmers should read these manuals before 
using this language reference manual. 

STRUCTURE OF THIS DOCUMENT 

This manual is organized into six chapters and five appendixes, as 
follows: 

• Chapter 1 introduces the features of the VAX-11 MACRO language 

• Chapter 2 describes the format used in VAX-11 MACRO source 
statements 

• Chapter 3 describes the components of VAX-11 MACRO source 
statements: the character set; numbers; symbols; local 
labels; terms and expressions; unary and binary operators; 
direct assignment statements; and the current location 
counter 

• Chapter 4 summarizes and gives examples of the use of the 
VAX-11 MACRO addressing modes 

• Chapter 5 describes the VAX-11 MACRO general assembler 
directives 

• Chapter 6 describes the directives used in defining and 
expanding macros 

• Appendix A lists the ASCII character set that can be used in 
VAX-11 MACRO programs 



vn 



• Appendix B summarizes the general assembler and macro 
directives (in alphabetical order), special characters, unary 
operators, binary operators, and addressing modes 

• Appendix C lists alphabetically the permanent symbols defined 
for use with VAX-11 MACRO 

• Appendix D gives rules for hexadecimal/decimal conversion 

ASSOCIATED DOCUMENTS 

The following documents are relevant to VAX-11 MACRO programming: 

• VAX-11 MACRO User's Guide 

• VAX/VMS Command Language User's Guide 

• VAX-11 Linker Reference Manual 

• VAX-11 Symbolic Debugger Reference Manual 

For a complete list of all VAX-11 documents, including a brief 
description of each, see the VAX-11 Information Directory . 

CONVENTIONS USED IN THIS DOCUMENT 

The following conventions are observed in this manual, as in the other 
VAX-11 documents: 

• Brackets ([]) indicate that the enclosed argument is optional 

• Uppercase words and letters, used in formats, indicate that 
the word or letter s .ould be typed exactly as shown 

• Lowercase words and etters, used in formats, indicate that a 
word or value of the user's choice is to be substituted 

• Ellipses (...) indicate that the preceding item(s) can be 
repeated one or more times 
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SUMMARY OF TECHNICAL CHANGES 



This manual documents VAX-11 MACRO V2.0. 
technical changes from Version 1. 



This section summarizes the 



The following new directives have been added: 

• .ASCID - stores an ASCII string with a string descriptor 

• .CROSS and .NOCROSS - control the cross reference listing 

• .DEFAULT - controls the default displacement 

• .OPDEF - defines an opcode 

• .SIGNED_BYTE and ,SIGNED_WORD - specify signed data storage 
The following directives have had new arguments added: 

• .ENABLE=SUPPRESSION - suppresses listing of unreferenced 
symbols in the symbol table 

• ,SAVE_PSECT LOCAL_BLOCK - preserves the local label block when 
the program section is saved 

In addition, new forms of directives and directive arguments have been 
added to make VAX-11 MACRO programs easier to read. These new forms 
have the same effect as their equivalent old form. The old forms are 
still accepted by the assembler. The following new forms of 
directives have been added: 



New Form 


Old Form 


.DISABLE 


. DSABL 


. ENABLE 


.ENABL 


.EXTERNAL 


. EXTRN 


. GLOBAL 


.GLOBL 


.IF FALSE 


.IFF 


.IF~TRUE 


.IFT 


.IF TRUE FALSE 


.IFTF 


.NOSHOW 


.NLIST 


. REPEAT 


.REPT 


.RESTORE PSECT 


.RESTORE 


.SAVE PSECT 


.SAVE 


.SHOW 


• LIST 


.SUBTITLE 


.SBTTL 



IX 



New forms have been added for symbolic arguments for the .ENABLE, 
.DISABLE, .SHOW, and .NOSHOW directives and for the condition tests 
used in the .IF and .IIF directives. 

All the preceding directives are described in Chapter 5 except the 
.REPEAT directive which is described in Chapter 6. 

Three new macro string operators, %LENGTH, %LOCATE, and %EXTRACT, have 
been added to allow string manipulation in macros. These string 
operators are described in Section 6.1.7. 

The following miscellaneous changes have also been made: 

• The assembler checks that the correct number of arguments are 
specified in a macro call. 

• The register mask in the .ENTRY directive must be an absolute 
expression. 

• In data storage directives with a repetition factor, only the 
repetition factor must be an absolute expression. The 
expression specifying the value to be stored can be any kind 
of expression (documentation change) . 

• The general addressing mode is indexable (documentation 
change) . 
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CHAPTER 1 
INTRODUCTION 



The VAX-11 MACRO assembler translates source programs into object (or 
binary) code and produces a listing file and an object module file. 
The VAX-11 Linker then combines object modules to produce an 
executable image. See the VAX-11 MACRO User's Guide for more 
information on using the assembler. This chapter introduces the 
features of the VAX-11 MACRO language. 

VAX-11 MACRO source programs consist of a series of source statements. 
Each statement can contain an instruction, an assembler directive, or 
a direct assignment statement. The instructions, which can be any of 
the VAX-11/780 native mode instructions, can perform many types of 
data manipulation such as multiplication, transfer of control, and 
data conversion. The instructions are described in the VAX-11/780 
Architecture Handbook . The assembler directives and direct assignment 
statements create and initialize data areas and provide tools for 
using the instructions. 

Source statements have four fields: label, operator, operand, and 
comment. The label field identifies the location in the program. The 
operator field contains the instruction opcode or directive. The 
operand field contains the instruction operands or the directive 
arguments. The instruction operands specify the locations that are 
accessed by the instruction. The comment field explains the meaning 
of the statement. 

There are two classes of assembler directives: the general assembler 
directives and the macro directives. 

The general assembler directives can be used to perform the following: 

• Store data or reserve memory for data storage 

• Control the alignment in memory of parts of the program 

• Specify the methods of accessing the sections of memory in 
which the program will be stored. 

• Specify the entry point of the program or of part of the 
program 

• Specify the way in which symbols will be referenced 

• Specify that a part of the program is to be assembled only 
under certain conditions 

• Control the format and content of the listing file 

• Display informational messages 



1-1 



INTRODUCTION 

• Control the assembler options that are used to interpret the 
source program 

• Define new opcodes 

The macro directives are used to define macros and repeat blocks, 
which allow a programmer to repeat identical or similar series of 
source statements throughout a program without having to reenter the 
statements each time. Macros and repeat blocks can thus help minimize 
programmer errors. 
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CHAPTER 2 
MACRO SOURCE STATEMENT FORMAT 



A source program consists of a sequence of source statements, which 
the assembler interprets and processes, one by one, generating object 
code or performing a specific assembly-time process. A source 
statement can be on one source line or can extend onto several source 
lines. Each source line can be up to 132 characters long; however, 
no line should exceed 80 characters to ensure that the source line 
fits (with the binary expansion) on one line in the listing file. 

MACRO statements can consist of up to four fields: 

• Label field — allows the program to symbolically define a 
location in a program 

• Operator field — specifies the action to be performed by the 
statement; this field can be an instruction, an assembler 
directive, or a macro call 

• Operand field — contains the instruction operand (s) or the 
assembler directive argument (s) or the -macro argument (s) 

• Comment field — contains a comment that explains the meaning 
of the statement; this field does not affect program 
execution 

The label field and the comment field are optional. The label field 
ends with a colon (:) and the comment field starts with a semicolon 
(;). The operand field must conform to the format of the instruction, 
directive, or macro specified in the operator field. 

Although the statement fields can be separated by a space or tab (see 
Table 3-2) , formatting statements with the tab character is 
recommended for consistency and clarity. By DIGITAL convention, tab 
characters are used to separate the statement fields as follows: 

Field Begins in Column Tab Characters to Reach Column 



Label 


1 


Operator 


9 


Operand 


17 


Comment 


41 
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For example: 



MACRO SOURCE STATEMENT FORMAT 



LABT: 
LAB 2: 



. TITLE ROUT1 

•ENTRY START, 

CLRL RO 

SUBL3 #10,4(AP)R2 

BRB CONT 



BEGINNING OF ROUTINE 

CLEAR REGISTER 

SUBTRACT 10 

BRANCH TO ANOTHER ROUTINE 



A single statement can be continued on several lines by using a hyphen 
(-) as the last nonblank character before the comment field or at the 
end of line (when there is no comment). For example: 

LABI: MOVAL W"BOO$AL_VECTOR,- ; SAVE ADDRESS OF 

RPB$.L_IOVEC(R7) ; BOOT DEVICE DRIVER. 

VAX-11 MACRO treats the above statement as equivalent to the following 
statement: 

LABI: MOVAL VTbOO$AL_VECTOR,RPB$L_IOVEC (R7) ; SAVE BOOT DRIVER 

A statement can be continued at any point. But user-defined and 
permanent symbol names should not be continued on two lines. If a 
symbol name is continued and the first character on the second line is 
a tab or a blank, the symbol name will be terminated at that 
character. (Section 3.3 describes symbols in detail.) 

Note that when a statement occurs in a macro definition (see Chapter 
6), the statement cannot contain more than 500 characters. 

Blank lines, although legal, have no significance in the source 
program except that they terminate a continued line. 

The following sections describe each of the statement fields in 
detail . 



2.1 LABEL FIELD 



A label is a 
program. The 
at the locati 
the VAX-11 



The user-defi 
contain any 
($) , and peri 
forming user-i 



user-defined symbol that identifies a location in the 

symbol is assigned a value equal to the location counter 

on in the program section in which the label occurs (see 

MACRO User's Guide for information on program sections) . 



ned symbol name can be up to 15 characters long and can 

alphanumeric character and the underline (_) , dollar sign 

od (.) characters. Section 3.3 describes the rules for 
defined symbol names in more detail. 



If a statement contains a label, the label must be in the first field 
on the line. 

A label is terminated by a colon (:) or a double colon (::). The 
single colon indicates that the label is defined only for the current 
module (an internal symbol). A double colon indicates that the label 
is globally defined; that is, the label can be referenced by other 
object modules (see Section 3.3.2). 

Once a label is defined, it cannot be redefined during the source 
program. If a label is defined more than once, VAX-11 MACRO displays 
an error message when the label is defined and again when it is 
referenced. 
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MACRO SOURCE STATEMENT FORMAT 



If a label extends past column 7, it should be placed on 
itself so that the operator field can start in column 9. 



a line by 



For example: 

EVAL : CLRL 
ERROR IN_ARG: 
INCL 
TEST:: MOVL 

TEST1 : BRW 
EXP: .BLKL 
DATA:: .BLKW 



RO 

RO 
EXP,R1 

EXIT ROU 

50 

25 



ROUTINE EVALUATES EXPRESSIONS 
THE ARG-LIST CONTAINS AN ERRO) 
INCREMENT ERROR COUNT 
THIS TESTS ROUTINE 
REFERENCED EXTERNALLY 
GO TO EXIT ROUTINE 
TABLES STORES EXPECTED VALUES 
DATA TABLE ACCESSED BY STORE 
ROUTINE IN ALGO MODULE 



2.2 OPERATOR FIELD 

The operator field specifies the action to 
statement. This field can contain either 
assembler directive, or a macro call. 



be performed by the 
an instruction, or an 



When the operator is an instruction, VAX-11 MACRO generates the binary 
code for that instruction in the object module; the instruction set 
is described in the VAX-11/780 Architecture Handbook . When the 
operator is a directive, VAX-11 MACRO performs certain control actions 
or processing operations during source program assembly; the 
assembler directives are described in Chapters 5 and 6 of this manual. 
When the operator is a macro call, VAX-11 MACRO expands the macro; 
macro calls are described in Chapter 6. 



Either a space or a tab character terminates the operator 
however, the tab is the recommended terminating character. 



field; 



2.3 OPERAND FIELD 

The operand field can contain operands for instructions or arguments 
for assembler directives or macro calls. 

Operands for instructions specify the locations in memory or the 
registers that are used by the machine operation. Operands for 
instructions specify the addressing mode for the instruction. Chapter 
4 describes the VAX-11 addressing modes. The operand field for a 
specific instruction must contain the number of operands required by 
that instruction. See the VAX-11/780 Architecture Handbook for a 
description of the instructions and their operands. 

Arguments for a directive must meet the format requirements of the 
directive. Chapters 5 and 6 describe the directives and the format of 
their arguments. 

Operands for a macro must meet the requirements specified in the macro 
definition. See the description of the .MACRO directive in Chapter 6. 

If two or more operands are specified, they should be separated by 
commas. VAX-11 MACRO also allows a space or tab to be used as a 
separator for arguments to directives that do not accept expressions 
(see Section 3.5). However, a comma is required to separate operands 
for instructions and for directives that accept expressions as 
arguments. 
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MACRO SODRCE STATEMENT FORMAT 

The semicolon that starts the comment field terminates the operand 
field. If a line does not have a comment field, the operand field is 
terminated by the end of the line. 



2.4 COMMENT FIELD 

The comment field contains text that explains the meaning of the 
statement. Every line of code should have a comment. Comments do not 
affect assembly processing or program execution except for messages 
displayed during assembly by the .ERROR, .PRINT, and .WARN directives 
(see descriptions in Chapter 5). 

The comment field must be preceded by a semicolon and is terminated by 
the end of the line. The comment field can contain any printable 
ASCII character (see Appendix A) . 

If a comment does not fit on one line, it can be continued on the 
next, but the continuation must be preceded by another semicolon. A 
comment can appear on a line by itself. 

The comment's text normally conveys the meaning rather than the action 
of the statement. The instruction MOVAL BUF PTR 1,R7, for instance, 
should have a comment such as "GET POINTER TO FIRST BUFFER" not "MOVE 
ADDRESS OF BUF_PTR 1 TO R7." 

For example: 

MOVAL 

MOVZWL 



MOVL 



STRING_DES_1,R0 

(R0),R1 
4(R0),R0 



GET ADDRESS OF STRING 

DESCRIPTOR 

GET LENGTH OF STRING 

GET ADDRESS OF STRING 
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CHAPTER 3 
THE COMPONENTS OF MACRO SOURCE STATEMENTS 



This chapter describes the components of VAX-11 MACRO source 
statements. These components consist of the character set; numbers; 
symbols; local labels; terms and expressions; unary and binary 
operators; direct assignment statements; and the current location 
counter . 



3.1 CHARACTER SET 

The following characters can be used in VAX-11 MACRO source 
statements: 

• Both uppercase and lowercase letters (A through Z, a through 
z) are accepted. However, the assembler considers lowercase 
letters equivalent to uppercase except when they appear in 
ASCII strings. 

• The digits through 9. 

• The special characters listed in Table 3-1. 



Table 3-1 
Special Characters Used in VAX-11 MACRO Statements 



Character 


Character Name 


Function 




Underline 


Character in symbol names 


$ 


Dollar sign 


Character in symbol names 


• 


Period 


Character in symbol names, 
current location counter, and 
decimal point 


: 


Colon 


Label terminator 


= 


Equal sign 


Direct assignment operator and 
macro keyword argument terminator 




Tab 


Field terminator 




Space 


Field terminator 



(continued on next page) 
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THE COMPONENTS OF MACRO SOURCE STATEMENTS 



Table 3-1 (Cont.) 
Special Characters Used in VAX-11 MACRO Statements 



Character 


Character Name 


Function 


# 


Number sign 


Immediate addressing mode 
indicator 


e 


At sign 


Deferred addressing mode 
indicator and arithmetic shift 
operator 


i 


Comma 


Field, operand, and item 
separator 


r 


Semicolon 


Comment field indicator 


+ 


Plus sign 


Autoincrement addressing mode 
indicator, unary plus operator, 
and arithmetic addition operator 




Minus sign or 
hyphen 


Autodecrement addressing mode 
indicator, unary minus operator, 
arithmetic subtraction operator, 
and line continuation indicator 


* 


Asterisk 


Arithmetic multiplication 
operator 


/ 


Slash 


Arithmetic division operator 


& 


Ampersand 


Logical AND operator 


1 


Exclamation 
point 


Logical inclusive OR operator 


\ 


Backslash 


Logical exclusive OR and numeric 
conversion indicator in macro 
arguments 




Circumflex 


Unary operators and macro 
argument delimiter 


n 


Square brackets 


Index addressing mode and repeat 
count indicators 





Parentheses 


Register deferred addressing mode 
indicators 


<> 


Angle brackets 


Argument or expression grouping 
delimiters 


? 


Question mark 


Created label indicator in macro 
arguments 


i 


Apostrophe 


Macro argument concatenation 
indicator 


% 


Percent sign 


Macro string operators 



Table 3-2 defines the separating characters used in VAX-11 MACRO. 
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Table 3-2 
Separating Characters in VAX-11 MACRO Statements 



Character 


Character Name 


Usage 




Space or tab 


Separator between statement 
fields. Spaces within 
expressions (see Section 3.5) are 
ignored. 


t 


Comma 


Separator between symbolic 
arguments within the operand 
field. Multiple expressions in 
the operand field must be 
separated by commas. 



3 . 2 NUMBERS 

Numbers can be integers, floating-point numbers, or packed decimal 
strings. 



3.2.1 Integers 

Integers can be used in any expression including expressions in 
operands and in direct assignment statements (Section 3.5 describes 
expressions) . 

Format 

snn 



s 



An optional sign: plus sign (+) for positive numbers (the 
default) or minus sign (-) for negative numbers. 



nn 



A string of numeric characters that are legal for the 
radix. 



current 



VAX-11 MACRO interprets all integers in the source program as decimal 
unless the number is preceded by a radix control operator (see Section 
3.6.1) . 

Integers must be in the range of -2147483648 through 2147483647 for 
signed data or in the range of through 4294967295 for unsigned data. 

Negative numbers must be preceded by a minus sign; VAX-11 MACRO 
translates such numbers into 2's complement form. In positive 
numbers, the plus sign is optional. 



3.2.2 Floating-Point Numbers 

A floating-point number can be used in the .FLOAT and .DOUBLE 
directives (described in Chapter 5) or as an operand in a 
floating-point instruction. A floating-point number cannot be used in 
an expression or with a unary or binary operator except the unary 
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plus, unary minus, and unary floating-point operator (~F) . Sections 
3.6 and 3.7 describe unary and binary operators. 

A floating-point number can be specified with or without an exponent. 

Formats 

Floating-point number without exponent: 

snn 

snn.nn 

snn. 

Floating-point number with exponent: 

snnEsnn 

snn.nnEsnn 

snn.Esnn 

s 

An optional sign. 



nn 



A string of decimal digits in the range of through 9. 



The decimal point can appear anywhere to the right of the first digit. 
However, note that a floating-point number cannot start with a decimal 
point because VAX-11 MACRO will treat the number as a user-defined 
symbol (see Section 3.3.2). 

Floating-point numbers can be either single-precision (32-bit) or 

double-precision (64-bit) quantities. The degree of precision is 7 

digits for single-precision numbers and 16 digits for double-precision 
numbers. 

The magnitude of a nonzero floating-point number cannot be smaller 
than approximately 0.29E-38 or greater than approximately 1.7E38. 

Single-precision floating-point numbers can be rounded (by default) or 
truncated. The .ENABLE and .DISABLE directives (described in Chapter 
5) control whether single-precision floating-point numbers are rounded 
or truncated. Double-precision floating point numbers are always 
rounded. 

The VAX-11/780 Architecture Handbook describes the internal format of 
floating-point numbers. 



3.2.3 Packed Decimal Strings 

A packed decimal string can be used only in the .PACKED directive 
(described in Chapter 5) . 

Format 

snn 

s 

An optional sign. 

nn 

A string of from 1 to 31 decimal digits in the range of through 

-7 • 
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A packed decimal string cannot have a decimal point or an exponent. 

The VAX-11/780 Architecture Handbook describes the internal format of 
packed decimal strings. 



3 . 3 SYMBOLS 

Three types of symbols can be used in VAX-11 MACRO source programs: 
permanent symbols, user-defined symbols, and macro names. 



3.3.1 Permanent Symbols 

Permanent symbols consist of the instruction mnemonics (see Appendix 
C) , the VAX-11 MACRO directives (see Chapters 5 and 6) , and the 
register names. The instruction mnemonics and directives need not be 
defined before being used in the operator field of a VAX-11 MACRO 
source statement. The register names need not be defined before being 
used in the addressing modes (see Chapter 4) . The register names 
cannot be redefined; that is, no user-defined symbol can have one of 
the register names listed below. 

The 16 general registers of the VAX-11/780 processor can be expressed 
in a source program only as follows: 

Register 

Name Processor Register 

RO General register 

Rl General register 1 

R2 General register 2 



Rll General register 11 

R12 or General register 12 or argument pointer. If R12 is 
AP used as an argument pointer, the name AP is 

recommended; if R12 is used as a general register, 

the name R12 is recommended. 

FP Frame pointer 
SP Stack pointer 
PC Program counter 
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3.3.2 Dser -defined Symbols and Macro Names 

User-defined symbols can be used as labels or can be equated to a 
specific value by a direct assignment statement (see Section 3.8). 

User-defined symbols also can be used in any expression (see Section 

The following rules govern the creation of user-defined symbols: 

• User-defined symbols can be composed of alphanumeric 
characters, underlines ( ), dollar signs {$), and periods (.). 
Any other character terminates the symbol. 

• The first character of a symbol must not be a number. 

• The symbol must be no more than 15 characters long and must be 
unique. 

In addition, by DIGITAL convention: 

• The dollar sign ($) is reserved for names defined by DIGITAL. 
This convention ensures that a user-defined name (which does 
not have a dollar sign) will not conflict with a 
DIGITAL-def ined name (which does have a dollar sign) . 

• The period (.) should not be used in any global symbol name 
(see Section 3.3.3) because other languages, such as FORTRAN, 

do not allow periods in symbol names. 

Macro names follow the same rules and conventions as user-defined 
symbols (see the description of the .MACRO directive in Chapter 6 for 
more information on macro names) . User-defined symbols and macro 
names do not conflict; that is, the same name can be used for a 
user-defined symbol and a macro. However, to avoid confusion, 
user-defined symbols and macros should be given different names. 



3.3.3 Determining Symbol Values 

The value of a symbol depends on its use in the program. VAX-11 MACRO 
uses a different method to determine the values of symbols in the 
operator field than it uses to determine the values of symbols in the 
operand field. 

A symbol in the operator field can be either a permanent symbol or a 
macro name. VAX-11 MACRO searches for a symbol definition in the 
following order: 

• Previously defined macro names 

• User-defined opcode (see the .OPDEF description in Chapter 5) 

• Permanent symbols (instructions and directives) 

• Macro libraries 

This search order allows permanent symbols to be redefined as macro 
names, if a symbol in the operator field is not defined as a macro or 
a permanent symbol, the assembler displays an error message. 

A symbol in the operand field must be either a user-defined symbol or 
a register name. 
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User-defined symbols can be either local (internal) symbols or global 
(external) symbols. Whether symbols are local or global depends on 
their use in the source program. 

A local symbol can be referenced only in the module in which it is 
defined. If local symbols with the same names are defined in 
different modules, the symbols are completely independent. A global 
symbol's definition, however, can be referenced from any module in the 
program. 

Normally, VAX-11 MACRO treats all user-defined symbols as local when 
they are defined. However, a symbol definition can be explicitly 
declared to be global by any one of the following three methods: 



Use of the double colon (::) in defining a label (see 
2.1) 



Section 



Use of the double equal sign 
statement (see Section 3.8) 



(==) in a direct assignment 



• Use of the .GLOBAL, .ENTRY, or .WEAK directive (see Chapter 5) 

When a symbol is referenced within the module in which it is defined, 
VAX-11 MACRO considers the reference an internal reference. When a 
symbol is referenced within a module in which it is not defi'ned, 
VAX-11 MACRO considers the reference an external reference (that is, 
the symbol is defined in another module). The .DISABLE directive can 
be used to make references to symbols not defined in the current 
module illegal. In this case, the .EXTERNAL directive must be used to 
specify that the reference is an external reference. See Chapter 5 
for descriptions of the .DISABLE and .EXTERNAL directives. 



3.4 LOCAL LABELS 

Local labels are used to identify addresses within a block of source 
code. 

Format 

nn$ 

nn 

A decimal integer in the range of 1 through 65535. 

Local labels can be used in the same way as user-defined symbol 
labels, but with the following differences: 

• Local labels cannot be referenced outside the block of source 
code in which they appear. 

• Local labels can be reused in another block of source code. 

• Local labels do not appear in the symbol tables and, thus, 
cannot be accessed by the debugger . 

• Local labels cannot be used in .END (see Chapter 5) 

By convention, local labels are positioned the same as statement 
labels; that is, they are left-justified in the source text. 
Although local labels can appear in the program in any order, by 
convention, the local labels in any block of source code should be in 
numeric order. 
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Local labels are useful as branch addresses when the address is used 
only within the block. Local labels distinguish between labels that 
are used only in a small block of code and labels that are referenced 
elsewhere in the module. A disadvantage of local labels is that their 
numeric names cannot provide any indication of their purpose. 
Consequently, local labels should not be used to label logically 
unrelated sequences of statements; user-defined symbols should be 
used instead. 



DIGITAL recommends that users create local labels only in the range of 
1? to 29999$ because the assembler automatically creates local labels 
in the range of 30000$ to 65535$ for use in macros (see Section 
6.1.6) . 



A local label block is delimited by the following statements: 
• A user-defined label 



• A .PSECT directive (see Chapter 5) 

• The .ENABLE and .DISABLE directives (see Chapter 5) which can 
extend a local label block beyond user-defined labels and 
•PSECT directives 

A local label block is usually delimited by two user-defined labels 
However, the .ENABLE LOCAL BLOCK directive starts a local block that 
is terminated only by one of~the following: 



A second .ENABLE LOCAL_BLOCK directive 

A .DISABLE LOCAL_BLOCK directive followed 
label or a .PSECT directive 



by a user-defined 



Although local label blocks can extend from one program section to 
another, DIGITAL recommends that local labels in one program section 
not be referenced from another program section. User-defined symbols 
should be used instead. 

An example showing the use of local labels follows. 

STARTS LOCAL LABEL BLOCK 
DEFINE LOCAL LABEL 10$ 
CONDITIONAL BRANCH TO LOCAL LABEL 
EXECUTED WHEN R0 NOT > 
ENDS PREVIOUS LOCAL LABEL 
BLOCK AND STARTS NEW ONE 
DEFINE NEW LOCAL LABEL 10$ 
CONDITIONAL BRANCH TO LOCAL LABEL 
EXECUTED WHEN R0 NOT > Rl 

• • • 

UNCONDITIONAL BRANCH TO LOCAL LABEL 

DEFINE LOCAL LABEL 

UNCONDITIONAL BRANCH TO 

USER-DEFINED LABEL 

START LOCAL LABEL BLOCK 

THAT WILL NOT BE TERMINATED 

BY A USER-DEFINED LABEL 

BRANCH TO LOCAL LABEL THAT IS AFTER 

A USER-DEFINED LABEL 

DOES NOT START A NEW 

LOCAL LABEL BLOCK 



RPSUB : 


MOVL 


AMOUNT, R0 


10$: 


SUBL2 


DELTA, R0 




BGTR 


10$ 




ADDL2 


DELTA, R0 


COMP: 


MOVL 


MAX,R1 




CLRL 


R2 


10$: 


CMPL 


R0,R1 




BGTR 


20$ 




SUBL 


INCR,R0 




INCL 


R2 




BRB 


10$ 


20$: 


MOVL 


R2, COUNT 




BRW 


TEST 



ENTR1 : 



.ENABLE LOCAL BLOCK 
POPR #~M<R0\R1,R2> 
ADDL3 R0,R1,R3 
BRB 10$ 



ENTR2: SUBL2 R2,R3 



3-8 



THE COMPONENTS OF MACRO SOURCE STATEMENTS 



10$: SUBL2 R2,R3 

BGTR 20$ 

INCL R0 

BRB NEXT 

20$: DECL R0 

.DISABLE LOCAL_BLOCK 

NEXT: CLRL R4 



DEFINE LOCAL LABEL 

CONDITIONAL BRANCH TO LOCAL LABEL 

EXECUTED WHEN R2 NOT > R3 

UNCONDITIONAL BRANCH TO 

USER-DEFINED LABEL 

DEFINE LOCAL LABEL 

DIRECTIVE FOLLOWED 

BY USER-DEFINED LABEL TERMINATES 

LOCAL LABEL BLOCK 



3.5 TERMS AND EXPRESSIONS 
A term can be any one of the following: 
• A number 



• A symbol 

• The current location counter (see Section 3.9) 

• A textual operator followed by text (see Section 3.6.2) 



Any of the above preceded by a 
3.6) 



unary operator (see Section 



VAX-11 MACRO evaluates terms' as longword (4-byte) values. If an 
undefined symbol is used as a term, the linker determines the term's 
value. The current location counter (.) has the value of the location 
counter at the start of the current operand. 

Expressions are combinations of terms joined by binary operators (see 
Section 3.7) and evaluated as longword (4-byte) values. VAX-11 MACRO 
evaluates expressions from left to right with no operator precedence 
rules. However, angle brackets (<>) can be used to change the order 
of evaluation. Any part of an expression that is enclosed in angle 
brackets is first evaluated to a single value, which is then used in 
evaluating the complete expression. For example, the expressions 
A*B+C and A*<B+C> are different. Angle brackets can also be used to 
apply a unary operator to an entire expression, such as -<A+B>. 

Note that unary operators are considered part of a term; thus, VAX-11 
MACRO performs the action indicated by a unary operator before it 
performs the action indicated by any binary operator. 



All expressions are one of three 
external (global). 



types: 



relocatable, absolute, or 



An expression is relocatable if its value is fixed relative to 
the start of the program section in which it appears. The 
current location counter is relocatable in a relocatable 
program section. 

An expression is absolute if its value is an assembly-time 
constant. An expression whose terms are all numbers is 
absolute. An expression that consists of a relocatable term 
minus another relocatable term from the same program section 
is absolute, because such an expression reduces to an 
assembly-time constant. 



An expression is external if it contains one or 
that are not defined in the current module. 



more symbols 
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Any type of expression can be used in most macro statements, but 
restrictions are placed on expressions used in: 

• .ALIGN alignment directive 

• .BLKx storage allocation directives 

• .IF and .IIF conditional assembly block directives 

• .REPEAT repeat block directive 

• .OPDEF opcode definition directive 

• .ENTRY entry point directive 

• .BYTE, .LONG, .WORD, .SIGNED_BYTE, and .SIGNED_WORD directive 
repetition factors 

• Direct assignment statements (see Section 3.8) 

See Chapter 5 for descriptions of the directives listed above, except 
.REPEAT which is described in Chapter 6. Expressions used in these 
directives and in direct assignment statements can only contain 
symbols that have been previously defined in the current module. They 
cannot contain either external symbols or symbols defined later in the 
current module. In addition, the expressions in these directives must 
be absolute. Expressions in direct assignment statements can be 
relocatable. 

An example showing the use of expressions follows. 



A = 2*100 




.BLKB 


A+50 


LAB : . BLKW 


A 


HALF = LAB+<A/2> 


LAB 2: .BLKB 


LAB 2 -LAB 


.WORD 


LAB3-LAB2 


LAB 3: .WORD 


TST+LAB+2 



2*100 IS AN ABSOLUTE EXPRESSION 
A+50 IS AN ABSOLUTE EXPRESSION A 
CONTAINS NO UNDEFINED SYMBOLS 
LAB IS RELOCATABLE 
LAB+<A/2> IS A RELOCATABLE 
EXPRESSION AND CONTAINS NO 
UNDEFINED SYMBOLS 

LAB2-LAB IS AN ABSOLUTE EXPRESSI 
AND CONTAINS NO UNDEFINED SYMBOL 
LAB3-LAB2 IS AN ABSOLUTE EXPRESS 
BUT CONTAINS THE SYMBOL LAB3 
THAT IS DEFINED LATER IN THIS MO 
TST+LAB+2 IS AN EXTERNAL EXPRESS 
BECAUSE TST IS AN EXTERNAL SYMBO! 



3.6 UNARY OPERATORS 

A unary operator modifies a term or an expression, and indicates an 
action to be performed on that term or expression. Expressions must 
be enclosed in angle brackets. Unary operators can be used to 
indicate whether a term or expression is positive or negative (if 
unary plus or minus is not specified, the value is assumed to be plus, 
by default). In addition, unary operators perform radix conversion, 
textual conversion (including ASCII conversion), and numeric control 
operations, as described in Sections 3.6.1 through 3.6.3. Table 3-3 
summarizes the unary operations. 
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Table 3-3 
Unary Operators 



Unary 
Operator 


Operator Name 


Example 


Operation 


+ 


Plus sign 


+A 


Results in the positive 
value of A 


— 


Minus sign 


-A 


Results in the negative 
(2's complement) value 
of A 


~B 


Binary 


"B11000111 


Specifies that 11000111 
is a binary number 


"D 


Decimal 


"D127 


Specifies that 127 is a 
decimal number 


"0 


Octal 


"034 


Specifies that 34 is an 
octal number 


"X 


Hexadecimal 


"XFCF9 


Specifies that FCF9 is 
a hexadecimal number 


"A 


ASCII 


"A/ABC/ 


Produces an ASCII 
string; the characters 
between the matching 
delimiters are 
converted to ASCII 
representation 


~M 


Register mask 


#~M<R3,R4,R5> 


Specifies the registers 
R3, R4, and R5 in the 
register mask 


~P 


Floating point 


~F3.0 


Specifies that 3.0 is a 
floating-point number 


*C 


Complement 


"C24 


Produces the l's 
complement value of 24 
(decimal) 



More than one unary operator can be applied to a single term or to an 
expression enclosed in angle brackets. For example: 

-+-A 

This construct is equivalent to: 

-<+<-A>> 



3.6.1 Radix Control Operators 

VAX-11 MACRO accepts terms or expressions in four different radixes: 
binary, decimal, octal, and hexadecimal. The default radix is 
decimal. Expressions must be enclosed in angle brackets. 
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Formats 



Bnn 
*Dnn 
"Onn 
*Xnn 



nn 



A string of characters that are legal in the specified 
The legal characters for each radix are listed below. 



radix. 



Format Radix Name 



Bnn 
'Dnn 



Binary 
Decimal 



Legal Characters 

and 1 

through 9 



Onn Octal through 7 

"Xnn Hexadecimal through 9 and A through F 

Radix control operators can be included in the source program anywhere 
a numeric value is legal. A radix control operator affects only the 
term or expression immediately following it, causing that term or 
expression to be evaluated in the specified radix. 



BINARY RADIX 

DECIMAL RADIX (DEFAULT) 

OCTAL RADIX 

13 IS IN OCTAL RADIX 

ALL NUMBERS IN EXPRESSION 

ARE IN HEXADECIMAL RADIX 

The circumflex cannot be separated from the B, D, 0, or X that follows 
it, but the entire radix control operator can be separated by spaces 
and tabs from the term or expression that is to be evaluated in that 
radix. 

The decimal operator, the default, is needed only within an expression 
that has another radix control operator. In the following example, 
the 16 would be interpreted as an octal number if the ~D operator did 
not precede it: 



For example: 




.WORD 


"B00001101 


.WORD 


"D123 


.WORD 


"041 


.WORD 


<A+"013> 


.LONG 


~X<FlC3+FFFFF-20> 



.LONG 



, O<10000 + 100 + "D16> 



3.6.2 Textual Operators 

The textual operators are the ASCII operator 
mask operator ("M) . 



,{~A.) <and the register 



3.6.2.1 ASCII Operator - The t ASCI I operator converts a string ®if 
printable characters to their fl-bit ASCII values and stores them one 
character to a byte. The string of characters must be enclosed in a 
pair of matching delimiters. 

The delimiters can be any printable character except the space, tab, 
or semicolon (;). Although alphanumeric characters can be used as 
delimiters, nonalphanumeric Characters should be used to avoid 
confusion. 
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Format 



"Astring 

string 

A delimited ASCII string from 1 through 8 characters long. 

The delimited ASCII string must not be larger than the data type of 
the operand. For example, if the "A operator occurs in an operand in 
a MOVW instruction (the data type is a word) , the delimited string 
cannot be more than two characters. 



For example: 

MOVL #~A/ABCD/,R0 



CMPW 



#"A/XY/,R0 



.QUAD ~A%1234/678% 
MOVL #"A/AB/,R0 



MOVES CHARACTERS A,B,C,D, 
INTO RO RIGHT JUSTIFIED WITH 
"A" IN LOW-ORDER BYTE AND "D" 
IN HIGH-ORDER BYTE 
COMPARES X AND Y AS ASCII 
CHARACTERS WITH CONTENTS OF LOW 
ORDER 2 BYTES OF RO 
GENERATES 8 BYTES OF ASCII DATA 
MOVE ASCII CHARACTERS AB INTO 
RO; "A" IN LOW-ORDER BYTE; "B" 
IN NEXT; AND ZERO THE 2 HIGH- 
ORDER BYTES 



3.6.2.2 Register Mask Operator - The register mask operator converts 
a register name or a list of register names enclosed in angle brackets 
into a 1- or 2-byte register mask. The register mask is used by the 
PUSHR and POPR instructions and the .ENTRY and .MASK directives (see 
Chapter 5) . 

Formats 

"Mreg-name 
"M<reg-name-list> 

reg-name 

One of the register names or the DV or IV arithmetic trap enable 
specifiers. 



reg-name-list 

A list of register names and/or the DV and 
enable specifiers, separated by commas. 



IV arithmetic trap 



The register mask operator sets a bit in the register mask for every 
register name or arithmetic trap enable specified in the list. The 
bits corresponding to each register name and arithmetic trap enable 
specifier are listed below. 
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Register Name 

RO through Rll 
R12 or AP 
FP 
SP 



Arithmetic Trap 
Enable 



IV 



DV 



Bits 

through 11 (respectively) 

12 

13 

14 

15 



When the register mask operator is used in a POPR or PUSHR 
instruction, RO through Rll, R12 or AP, FP, and SP can be specified. 
The PC register name and the IV and DV arithmetic trap enable 
specifiers cannot be specified. 

When the register mask operator is used in the .ENTRY or .MASK 
directives, R2 through Rll and the IV and DV arithmetic trap enable 
specifiers can be specified. However, RO, Rl, FP, SP, and PC cannot 
be specified. IV sets the integer overflow trap, and DV sets the 
decimal string overflow trap. 

See the VAX-11/780 Architecture Handbook for more information on 
register masks and arithmetic trap enable specifiers. 



For example: 

.ENTRY RT1,"M<R3,R4,R5,R6,IV> 

PUSHR #~M<R0,R1,R2,R3> 

POPR #~M<R0,R1,R2,R3> 



SAVE REGISTERS R3,R4 
R5, AND R6 AND SET THE 
INTEGER OVERFLOW TRAP 
SAVE REGISTERS R0,R1, 
R2, AND R3 
RESTORE R0,R1,R2, AND R3 



3.6.3 Numeric Control Operators 

The numeric control operators are the floating-point operator (~F) and 
the complement operator (~C) . 



3.6.3.1 Floating Point Operator - The floating-point operator accepts 
a floating-point number and converts it to its internal representation 
(a 4-byte value). This value can be used in any expression. VAX-11 
MACRO does not perform floating-point expression evaluation. 

Format 

"Fliteral 

literal 

A floating-point number (see Section 3.2.. 2). 

The floating-point operator is useful because it allows a 
floating-point number in an instruction that accepts integers. 



For example: 
MOVL 
MOVF 



#"F3.7,R0 
#3.7,R0 



NOTE THE RECOMMENDED INSTRUCTION 
TO MOVE THIS FLOATING-POINT NUMBE: 
IS THE MOVF INSTRUCTION 
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3.6.3.2 Complement Operator - The complement operator produces the 
l*s complement of the specified value. 



Format 



Cterm 



term 

Any term or expression. If an expression is specified, it must 
be enclosed in angle brackets. 

VAX-11 MACRO evaluates the term or expression as a 4-byte value before 
complementing it. 



For example: 

.LONG 
.LONG 



C XFF 
*C25 



PRODUCES FFFFFFOO (HEX) 
PRODUCES COMPLEMENT OF 
25 (DEC) WHICH IS 
FFFFFFE6 (HEX) 



3.7 BINARY OPERATORS 

In contrast to unary operators, binary operators specify actions to be 
performed on two terms or expressions. Expressions must be enclosed 
in angle brackets. Table 3-4 summarizes the binary operators. 



Table 3-4 
Binary Operators 



Binary 
Operator 


Operator Name 


Example 


Operation 


+ 


Plus sign 


A+B 


Addition 


- 


Minus sign 


A-B 


Subtraction 


* 


Asterisk 


A*B 


Multiplication 


/ 


Slash 


A/B 


Division 


@ 


At sign 


A@B 


Arithmetic shift 


& 


Ampersand 


A&B 


Logical AND 


! 


Exclamation point 


A!B 


Logical inclusive OR 


\ 


Backslash 


A\B 


Logical exclusive OR 



All binary operators have equal priority. Terms or expressions can be 
grouped for evaluation by enclosing them in angle brackets. The 
enclosed terms and expressions are then evaluated first, and remaining 
operations are performed from left to right. For example: 



LONG 1+2*3 
•LONG l+<2*3> 



; EQUALS 9 
; EQUALS 7 
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Note that a 4-byte result is returned from all binary operations. If 
a 1-byte or 2-byte operand is used, the result is the low-order 
byte(s) of the 4-byte result. VAX-11 MACRO displays an error message 
if the truncation causes a loss of significance. 

The following sections describe the arithmetic shift, logical AND, 
logical inclusive OR, and logical exclusive OR operators in more 
detail. 



3.7.1 Arithmetic Shift Operator 

The arithmetic shift operator (@) is used to perform left and right 
arithmetic shift of arithmetic quantities. The first argument is 
shifted left or right the number of bit positions specified by the 
second argument. If the second argument is positive, the first 
argument is shifted left; if the second argument is negative, the 
first argument is shifted right. When the first argument is shifted 
left, the low-order bits are set to 0; and when the first argument is 
shifted right, the high-order bits are set to the value of the 
original high-order bit (the sign bit) . 



For example: 



•LONG ~B101@4 

•LONG 1@2 

MOVL #<~B1100000@-5>,RO 



YIELDS 1010000 (BINARY) 
YIELDS 100 (BINARY) 
YIELDS 11 (BINARY) 



A = 4 



.LONG 
.LONG 



1(3 A 
~X1234@-A 



YIELDS 10000 (BINARY) 
YIELDS 123 (HEX) 



3.7.2 Logical AND Operator 

The logical AND operator (&) takes the logical AND of two operands. 

For example: 



A = B1010 
B = "B1100 

.LONG 



A&B 



YIELDS 1000 (BINARY) 



3.7.3 Logical Inclusive OR Operator 

The logical inclusive OR operator (!) takes the logical inclusive OR 
of two operands. 

For example: 



A = "B1010 
B = "B1100 

.LONG 



A!B 



; YIELDS 1110 (BINARY) 
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3.7.4 Logical Exclusive OR Operator 

The logical exclusive OR operator (\) takes the logical exclusive OR 
of two arguments. 

For example: 

A = "B1010 
B = "B1100 

•LONG A\B ; YIELDS 0110 (BINARY) 



3.8 DIRECT ASSIGNMENT STATEMENTS 

A direct assignment statement equates a symbol to a specific value. 
Unlike a symbol that is used as a label, a symbol defined with a 
direct assignment statement can be redefined as many times as desired. 

Formats 

symbol =expression 
symbol ==expression 

symbol 

A user-defined symbol. 

expression 

An expression that does not contain any undefined symbols (see 
Section 3.5) . 

The format with a single equal sign (=) defines a local symbol and the 
format with a double equal sign (==) defines a global symbol. See 
Section 3.3.3 for more information about local and global symbols. 

The following three syntactic rules apply to direct assignment 
statements: 

• An equal sign (=) or double equal sign (==) must separate the 
symbol from the expression defining the symbol's value. 
Spaces preceding and/or following the direct assignment 
operators have no significance in the resulting value. 

• Only one symbol can be defined in a single direct assignment 
statement. 

• A direct assignment statement can be followed only by a 
comment field. 

In addition, by DIGITAL convention, the symbol in a direct assignment 
statement is placed in the label field. 



For example: 

A ■ 1 

B s A@5 

C = 127*10 

D = *X100/~X10 

E = <B/10>+A1-<C> 



THE SYMBOL ^A' IS EQUATED 

TO THE VALUE 1 

THE SYMBOL 'B' IS EQUATED 

TO 1@5 OR 20 (HEX) 

THE SYMBOL 'C IS EQUATED 

TO 1270 (DEC) 

THE SYMBOL 'D' IS EQUATED 

TO 10 (HEX) 

THE SYMBOL 'E' IS EQUATED 

TO <1270/10>+32-16 

OR 143 (DECIMAL) 
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3.9 CURRENT LOCATION COUNTER 

The period (.), the symbol for the current location counter, always 
has the value of the address of the current byte. VAX-11 MACRO sets 
the current location counter to at the beginning of the assembly and 
at the beginning of each new program section. 

Every VAX-11 MACRO source statement that allocates memory in the 
object module increments the value of the current location counter by 
the number of bytes allocated. For example, the directive .LONG 
increments the current location counter by 4, but a direct assignment 
statement, except the special form described below, does not increase 
the current location counter because no memory is allocated. 

The current location counter can be explicitly set by a special form 
of the direct assignment statement. The location counter can be 
either incremented or decremented. Explicitly setting the location 
counter is often useful when defining data areas. Data storage area 
should not be reserved by explicitly setting the location counter; 
the .BLK directives should be used instead (see Chapter 5) . 

Format 

. =expression 

expression 

An expression that does not contain any undefined symbols (see 
Section 3.5). 

In a relocatable program section, the expression must be relocatable; 
that is, the expression must be relative to an address in the current 
program section (it can be relative to the current location counter). 

For example: 

. = .+40 ; MOVES LOCATION COUNTER 

; FORWARD 

When a program section previously defined in the current module is 
continued, the current location counter is set to the last value of 
the current location counter in that program section. 

When the current location counter is used in the operand field of an 
instruction, the current location counter has the value of the address 
of that operand — it does not have the value of the address of the 
beginning of the instruction. For this reason, the current location 
counter is not normally used as a part of the operand specifier. 
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ADDRESSING MODES 



This chapter summarizes the VAX-11 addressing modes and contains 
examples of VAX-11 MACRO statements that use these addressing modes. 
The VAX-11/780 Architecture Handbook describes the addressing modes in 
detail . 

There are four types of addressing modes: 

• General Register 

• Program Counter 

• Index 

• Branch 

Although index mode is a general register mode, it is considered a 
separate type of mode because it can be used only in combination with 
another type of mode. 

Table 4-1 summarizes the addressing modes. 



4.1 GENERAL REGISTER MODES 

The general register modes use registers RO through R12, AP (the same 
as R12) , FP, and SP. 

There are eight general register modes: 

• Register 

• Register Deferred 

• Autoincrement 

• Autoincrement Deferred 

• Autodecrement 

• Displacement 

• Displacement Deferred 

• Literal 
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4.1.1 Register Mode 

In register mode, the operand i 
register, except for quadword, 
field operands, where the operand 
concatenated with the contents of 
bytes of the operand are in regist 
are in register n+1. The result 
register mode or if SP is used in 
double-precision floating-point, o 

Formats 



s the contents of 
double-precision floa 

is the contents o 
register n+1. The lea 
er n and the most sign 
s are unpredictable if 

register mode with 
r field operand extend 



the specified 
ting-point, or 
f register n 
st significant 
ificant bytes 
PC is used in 
a quadword, 
ing into PC. 



Rn 
AP 
FP 
SP 



A number in the range of through 12. 
Example 



CLRB 
CLRQ 
TSTW 
INCL 



RO 
Rl 
RIO 
R4 



CLEAR LOWEST BYTE OF RO 
CLEAR Rl AND R2 
TEST LOWER WORD OF RIO 
ADD 1 TO R4 



4.1.2 Register Deferred Mode 

oo™;S Ster o de ? e 5 red S^ 8 ' the re 9 ister contains the address of the 
Section 4. 3 ^ egiSter defer "d mode Can be used with index mode (see 

Formats 

(Rn) 
(AP) 
(FP) 
(SP) 



A number in the range of through 12. 



Example 



10$: 



MOVAL 


LDATA,R3 


CMPL 


(R3) ,R0 


BEQL 


10$ 


CLRL 


(R3) 


MOVL 


(SP),R1 


MOVZBL 


(AP) ,R4 



MOVE ADDRESS .OF LDATA TO R3 
COMPARE VALUE AT LDATA TO RO 
IF THEY ARE THE SAME, IGNORE 
CLEAR LONGWORD AT LDATA 
COPY TOP ITEM OF STACK INTO Rl 
GET NUMBER OF ARGUMENTS IN CALL 



4.1.3 Auto increment Mode 

^ ^^ lnCr ^f nt m ° de ,' the re 9 ist er contains the address of the 
operand. After evaluating the operand address contained in the 
register, the processor increments that address by tb© size of tte 
operand data type. The processor increments the contents of the 
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or quadword 



register by 1, 2, 4, or 8 for a byte, word, longword, 
operand, respectively. 

Autoincrement mode can be used with index mode (see Section 4.3), but 
the index register cannot be the same as the register specified in 
autoincrement mode. 



Formats 



(Rn) + 
(AP) + 
(FP) + 
(SP) + 



A number in the range of through 12. 



Example 



MOVAL TABLE, Rl 

CLRQ (Rl)+ 

CLRL (Rl)+ 

MOVAB BYTARR,R2 

INCB (R2>+ 

INCB (R2)+ 

X0RL3 (R3)+, (R4)+, (R5)+ 



GET ADDRESS OF TABLE 
CLEAR FIRST AND SECOND LONGWORDS 
AND THIRD LONGWORD IN TABLE 
LEAVE Rl POINTING TO TABLE +12 
GET ADDRESS OF BYTARR 
INCREMENT FIRST BYTE OF BYTARR 
AND SECOND 

; EXCLUSIVE-OR THE TWO LONGWORDS 
WHOSE ADDRESSES ARE STORED IN 
R3 AND R4 AND STORE RESULT IN 
ADDRESS CONTAINED' IN R5, THEN 
ADD 4 TO R3, R4 , AND R5 



4.1.4 Autoincrement Deferred Mode 

In autoincrement deferred mode, the register contains an address that 
is the address of the operand address (a pointer to the operand). 
After evaluating the operand address, the processor increments the 
contents of the register by 4 (the size in bytes of an address) . 

Autoincrement deferred mode can be used with index mode (see Section 
4.3), but the indent register cannot be the same as the register 
specified in autoincrement deferred mode. 

Formats 

@(Rn)+ 
@(AP>+ 
@(FPJ + 
@(SP)+ 



A number in the range of through 12. 



Example 



MOVAL 
CLRQ 

CLRB 



PNTLIS,R2 
@(R2) + 



§(R2) + 



GET ADDRESS OF POINTER LIST 
CLEAR QUADWORD POINTED TO BY 
FIRST ABSOLUTE ADDRESS IN PNTLIS 
THEN ADD 4 TO R2 

CLEAR BYTE POINTED TO BY SECOND 
ABSOLUTE ADDRESS IN PNTLIS 
THEN ADD 4 TO R2 
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MOVL 



R10,@(R0)+ 



MOVE RIO TO LOCATION WHOSE ADDRESS 
IS POINTED TO BY RO; THEN ADD 4 
TO RO 



4.1.5 Autodecrement Mode 

In autodecrement mode, the processor decrements the contents of the 

n«ni!f!f i-^ *** Si " ° £ the °P eraRd dafc a type; then the register 
contains the address of tne operand. The processor decrements the 
register by 1, 2, 4, or 8 
operands, respectively. 



for byte, word, longword, or quadword 



Autodecrement mode can be used with index mode (see Section 4.3), but 
the index register cannot be the same as the register specified in 
autodecrement mode. 



Formats 



-(Rn) 
-CAP) 
-(PP) 
-(SP) 



A number in the range of through 12. 
Example 



CLRQ -(Rl) 
MOVZBL R3,-(SP) 
CMPB R1,-(R0) 



SUBTRACT 8 FROM Rl AND ZERO THE 

QUADWORD WHOSE ADDRESS IS THEN 

IN Rl 

PUSH THE ZERO-EXTENDED LOW BYTE 

OF R3 ONTO THE STACK AS A LONGWORD 

ONTO THE STACK 

SUBTRACT 1 FROM RO AND COMPARE LOW 

BYTE OF Rl WITH BYTE WHOSE ADDRESS 

IS NOW IN RO 



4.1.6 Displacement Mode 

In displacement mode, the sum of the contents of the register and the 
displacement (sign extended to a longword) Is the address of the 
operand. 

Displacement mode can be used with index mode (see Swtfttefo 4„3.H 
Formats 

dis (Rn) 
dis(AP) 
dis(FP) 
dis(SP) 



dis 



A number in the range of through 12. 

An expression specifying a displacement; the expression can be 
preceded by one of the following displacement length specifiers, 
which indicate the number of bytes needed to store the 
displacement. 
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Displacement 
Length Specifier 

B~ 
VT 
L~ 



Meaning 

displacement requires 1 byte 
Displacement requires 1 word (2 bytes) 
Displacement requires 1 longword (4 bytes) 



If no displacement length specified precedes the expression and 
the value of the expression is known, the assembler chooses the 
smallest number of bytes (1, 2, or 4) needed to store the 
displacement. If no length specifier precedes the expression and 
the value of the expression is unknown, the assembler reserves 1 
word (2 bytes) for the displacement. Note that if the 
displacement is either relocatable or defined later in the source 
program, the assembler considers it unknown. If the actual 
displacement does not fit in the memory reserved, the linker 
displays an error message. 



Example 



MOVAB 


KEYW0RDS,R3 


MOVB 


B~I0(R3) ,R4 


MOVB 


B'ACCOUNTfRS 


CLRW 


L"STA(R1) 


MOVL 


R0,-2(R2) 


TSTB 


EXTRN(R3) 



,R5 



MOVAB 2(R5),R0 



GET ADDRESS OF KEYWORDS 

GET BYTE WHOSE ADDRESS IS 

10 PLUS ADDRESS OF KEYWORDS 

THE DISPLACEMENT IS STORED AS A BYTE 

GET BYTE WHOSE ADDRESS IS ACCOUNT 

PLUS ADDRESS OF KEYWORDS 

THE DISPLACEMENT IS STORED AS A BYTE 

CLEAR WORD WHOSE ADDRESS 

IS STA PLUS CONTENTS OF Rl 

THE DISPLACEMENT IS STORED 

AS A LONGWORD 

MOVE RO TO ADDRESS THAT IS -2 

PLUS THE CONTENTS OF R2 

THE DISPLACEMENT IS STORED AS A BYTE 

TEST THE BYTE WHOSE ADDRESS 

IS EXTRN PLUS THE 

ADDRESS OF KEYWORDS 

THE DISPLACEMENT IS STORED AS A WORD 

SINCE EXTRN IS UNDEFINED 

MOVE <CONTENTS OF R5> + 2 

TO RO 



Note 



If the value of the displacement is and no displacement length 
is specified, the assembler uses register deferred mode rather 
than displacement mode. 



4,1.7 Displacement Deferred Mode 

In displacement deferred mode, the sum of the contents of the register 
and the displacement tsign extended to a longword) is the address of 
the operand address {a pointer to the operand) . 

Displacement deferred mode can be used with index mode (see Section 
4.3). 
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@dis(Rn) 
@dis(AP) 
@dis(FP) 
@dis(SP) 
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dis 



A number in the range of through 12. 



An expression specifying a displacement; the expression can be 
preceded by one of the following displacement length specifiers, 
which indicate the number of bytes needed to store the 
displacement. 



Displacement 
Length Specifier 

B" 

w 

L* 



Meaning 

Displacement requires 1 byte 
Displacement requires 1 word (2 bytes) 
Displacement requires 1 longword (4 bytes) 



If no displacement length specifier precedes the expressi 
the value of the- expression is know, the assembler choo 
smallest number of bytes (1, 2, or 4) needed to sto 
displacement. If no length specifier precedes the express 
the value of the expression is unknown, the assembler rese 
word (2 bytes) for the displacement. Note that 
displacement is either relocatable or defined later in the 
program, the assembler considers it unknown. If the 
displacement does not fit in the memory reserved, the 
displays an error message. 



on and 

ses the 

re the 

ion and 

rves 1 

if the 

source 

actual 

linker 



Example 



MOVAL 
CLRL 



MOVL 



ARRPOINT, R6 
@16(R6) 



CLRW $84 (R2) 



GET ADDRESS OF ARRAY OF POINTERS 
CLEAR LONGWORD POINTED TO BY 
LONGWORD WHOSE ADDRESS IS 16 
PLUS THE ADDRESS OF ARRPOINT 
. THE DISPLACEMENT IS STORED AS A BYTE 
eB~0FFS(R6) ,@RS0FF(R6) ; MOVE THE LONGWORD POINTED TO 
i BY LONGWORD WHOSE ADDRESS IS 
I OFFS PE.US THE ADDRESS OF ARRPOINT 
TO THE ADDRESS POINTED TO BY 
LONGWORD WHOSE ADDRESS IS 
RSOFFS PLUS THE ADDRESS OF ARRPOINT 
THE FIRST, DISPLACEMENT IS STORED AS A BYTE 
THE SECOND DISPLACEMENT IS STORED AS A W0R1 
CLEAR THE WORD THAT IS POINTED 
TO BY LONGWORD AT 84 PLUS THE 
CONTENT^ £>F R*H*-THE ASSEMBLER USES 
BYTE DISPLACEMENT AUTOMATICALLY; 



4.1.8 Literal Mode 

in literal mode, the value o.f the literal is stored in the addressing 
mode byte itself. 

Formats 

♦literal 
S~#literal 
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literal 

An expression, an integer constant, or a floating-point constant. 
The literal must fit in the short literal form. That is, 
integers must be in the range of through 63 and floating-point 
constants must be one of the 64 values listed in Table 4-2. 
Floating-point short literals are stored with a 3-bit exponent 
and a 3-bit fraction. Table 4-2 also shows the value of the 
exponent arid the fraction for each literal. See the VAX- 11 
Architecture Handbook for information on the format of short 
literals. 



Table 4-2 
Floating Point Short Literals 



n. Fraction 























1 


2 


3 


4 


5 


6 


7 


Exponent^. 





















,0.5 


0.5625 


0.625 


0.6875 


0.75 


0.8125 


0.875 


0.9375 


1 


l.ff 


1.125 


1.25 


1.37 


1.5 


1.625 


1.75 


1.875 


2 


2.0 


2.25 


2.5 


2.75 


3.0 


3.25 


3.5 


3.75 


3 


4.0 


4.5 


5.0 


5.5 


6.0 


6.5 


7.0 


7.5 


4 


8.0. 


9.0 


10.0 


11.0 


12.0 


13.0 


14.0 


15.0 


5 


16.0 


18.0 


20.0 


22.0 


24.0 


26.0 


28.0 


30.0 


6 


32.0 


36.0 


40.0 


44.0 


48.0 


52.0 


56.0 


60.0 


7 


64.0 


72.0 


80.0 


88.0 


96.0 


104.0 


112.0 


120.0 



Example 



MOVL #1,R0 



MOVB S"#CR,R1 



MOVF #0.625,R6 



R0 IS SET TO 1; THE 1 IS STORED 

IN THE INSTRUCTION AS A SHORT 

LITERAL 

THE LOW BYTE OF Rl IS SET 

TO THE VALUE CR 

cr is Stored in the instruction 

AS A SHORT LITERAL 

IF CR IS NOT IN RANGE 0-63, 

THE LINKER PRODUCES A TRUNCATION 

ERROft 

R6 IS SET TO THE FLOATING 

POINT VALUE 0.625; IT IS STORED 

IN THE FLOATING POINT SHORT 

LITERAL FORM 



Notes 



1. when the #J..Jte J ral fdrmafc is q«ed, the assembler chooses 
whether to use |i£#ral mode or immediate mode (see Section 
4.2,4), The assembler uses immediate mode if Any of the 
following conditions are met: 

• The value of nhe literal does not fit in the Short literal 
form 

• The literal is a ifeloca table" or external expression (see 
Se^tipn l>5) 

• The liter*! is an' sxprsssion that contains undefined 
symbols 
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The difference between immediate mode and literal mode is the 
amount of storage that it takes to store the literal in the 
instruction. 

2. The S~#literal format forces the assembler to use literal 
mode. 



4.2 PROGRAM COUNTER MODES 

The program counter modes use PC for a general register. 

There are five program counter modes: 

• Relative 

• Relative Deferred 

• Absolute 

• Immediate 

• General 

4.2.1 Relative Node 

In relative mode, the address specified is the address of the operand. 
The assembler stores the address as a displacement from PC. 

Relative mode can be used with index mode (see Section 4.3). 

Format 

address 

address 

An expression specifying an address; the expression can be 
preceded by one of the following displacement length specifiers, 
which indicate the number of bytes needed to store the 
displacement. 

Displacement 

Length Specifier Meaning 

B~ Displacement requires 1 byte 

W~ Displacement requires 1~ word (2 bytes) 

L* Displacement requires 1 longword (4 bytes) 

If no displacement length specifier precedes the address 
expression and the value of the expression is known, the 
assembler chooses the smallest number of bytes (1, 2, or 4) 
needed to store the displacement. If no length specifier 
precedes the address expression and the value of the expression 
is unknown, the assembler uses the default displacement length 
(see the description of .DEFAULT in Chapter 5). If the address 
expression is either defined later in the program or defined in 
another program section, the assembler considers the value 
unknown. 
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Example 



MOVL LABEL ,R1 



CMPL W~<DATA+4>,R10 



GET LONGWORD AT LABEL; THE 
ASSEMBLER USES DEFAULT 
DISPLACEMENT UNLESS LABEL 
PREVIOUSLY DEFINED IN THIS SECTION 
COMPARE RIO WITH LONGWORD AT 
ADDRESS DATA+4; THE ASSEMBLER 
USES A WORD DISPLACEMENT 



4.2.2 Relative Deferred Mode 

In relative deferred mode, the address specified is the address of the 
operand address (a pointer to the operand) . The assembler stores the 
address specified as a displacement from PC. 

Relative deferred mode can be used with index mode (see Section 4.3). 

Format 

@address 

address 

An expression specifying an address; the expression can be 
preceded by one of the following displacement length specifiers, 
which indicate the number of bytes needed to store the 
displacement. 



Displacement 
Length Specifier 

B~ 
W~ 
L" 

If no displacement 
expression and the 
assembler chooses the 
needed to store th 
precedes the address 
is unknown, the as 
(see the description 
expression is eithe 
another program sec 
unknown. 



Meaning 

Displacement requires 1 byte 
Displacement requires 1 word (2 bytes) 
Displacement requires 1 longword (4 bytes) 



length specifier precede 
value of the expression 
smallest number of bytes 
e displacement. If no 
expression and the value of 
sembler uses the default di 
of .DEFAULT in Chapter 5). 
r defined later in the prog 
tion, the assembler cons 



s the address 
is known, the 
(1, 2, or 4) 

length specifier 
the expression 

splacement length 
If the address 

ram or defined in 

iders the value 



Example 



CLRL @W~PNTR 



INCB @L~C0UNTS+4 



CLEAR LONGWORD POINTED TO BY 
LONGWORD AT PNTR; THE ASSEMBLER 
USES A WORD DISPLACEMENT 
INCREMENT BYTE POINTED TO BY 
LONGWORD AT COUNTS+4; ASSEMBLER 
USES A LONGWORD DISPLACEMENT 



4.2.3 Absolute Mode 

In absolute mode, the address specified is the address of the operand. 
The address is stored as an absolute virtual address (compare relative 
mode, where the address is stored as a displacement from PC). 
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Absolute mode can be used with index mode (see Section 4.3). 
Format 

@#address 

address 

An expression specifying an address. 



Example 



CLRL @#~X1100 
CLRB • @# ACCOUNT 



CALLS #3,@#SYS$FA0 



CLEAR THE CONTENTS OF LOCATION 1100 (HEX) 
CLEAR THE CONTENTS OF LOCATION 
ACCOUNT; THE ADDRESS IS STORED 
ABSOLUTELY, NOT AS A DISPLACEMENT 
CALL THE PROCEDURE SYS$FAO WITH 
THREE ARGUMENTS ON THE STACK 



4.2.4 Immediate Mode 

In immediate mode, the literal specified is the operand. 

Formats 

♦literal 
I^ffliteral 

literal 

An expression, an integer constant, or a floating-point constant. 



Example 



Notes 



MOVL 


#1000, R0 


MOVB 


#BAR,R1 


MOVF 


#0.1, R6 



ADDL2 I X #5,R0 



; R0 IS SET TO 1000; THE OPERAND 1000 

; IS STORED IN A LONGWORD 

f THE LOW BYTE OF Rl IS SET 
TO THE VALUE OF BAR 
R6 IS SET TO THE FLOATING 
POINT VALUE 0.1; IT IS STORED 
AS A 4-BYTE FLOATING POINT 
VALUE (IT CAN NOT BE 
REPRESENTED AS A SHORT LITERAL) 
THE 5 IS STORED IN A LONGWORD 
BECAUSE THE I" FORCES THE 
ASSEMBLER TO USE IMMEDIATE MODE; 



When the #literal format is used, the assembler chooses 
whether to use literal mode (Section 4.1.8) or immediate 
mode. If the literal is an integer from through 63 or a 
floating-point constant that fits in the short literal form, 
the assembler uses literal mode. if the literal is an 
expression, the assembler uses literal mode if all the 
following conditions are met: 

• The expression is absolute 

• The expression contains no undefined symbols 

• The value of the expression fits in the short literal form 
In all other cases, the assembler uses immediate mode. 
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The difference between immediate mode and literal mode is the 
amount of storage required to store the literal in the 
instruction. The assembler stores an immediate mode literal 
in a byte, word, or longword depending on the operand data 
type. 



2. The I~#literal format forces the assembler to 
mode. 



use immediate 



4.2.5 General Mode 

In general mode, the address specified is the address of the operand. 
The linker converts the addressing mode to either relative or absolute 
mode. If the address is relocatable, the linker converts general mode 
to relative mode. If the address is absolute, the linker converts 
general mode to absolute mode. General mode is used to write 
position-independent code when the programmer does not know whether 
the address is relocatable or absolute. A general addressing mode 
operand requires 5 bytes of storage. 

General mode can be used with index mode (see Section 4.3). 

Format 

G~address 

address 

An expression specifying an address. 

Example * 



CLRL G~LABEL 1 ; CLEARS THE LONGWORD AT LABEL 1 

IF LABEL 1 IS DEFINED AS ABSOLUTE 
THEN THIS* IS CONVERTED TO ABSOLUTE 
MODE; IF IT IS DEFINED AS 
RELOCATABLE, THEN THIS IS CONVERTED 
TO RELATIVE MODE 

CALLS #5,G~SYS$SERVICE ; CALLS PROCEDURE SYS$SERVICE 

; WITH 5 ARGUMENTS ON STACK 



4.3 INDEX MODE 

Index mode is a general register mode that can be used only in 
combination with another mode, called the base mode. The base mode 
can be any addressing mode except register, immediate, literal, index, 
or branch. The assembler first evaluates the base mode to get the 
base address. Then the assembler adds the base address to the product 
of the contents of the index register and the number of bytes of the 
operand data type. This sum is the operand address. 

Combining index mode with the other addressing modes produces the 
following addressing modes: 

• Register Deferred Index 

• Auto increment Index 

• Autoincrement Deferred Index 



• Autodecrement Index 
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Displacement Index 
Displacement Deferred Index 
Relative Index 
Relative Deferred Index 
Absolute Index 
General Index 



The process of first evaluating the base mode and then adding the 
index register is the same for each of these modes. 

Formats 

base-mode [Rx] 
base-mode [AP] 
base-mode [FP] 
base-mode [SP] 

base-mode 

Any addressing mode except register, immediate, literal, index, 
or branch, specifying the base address. 

x 

A number in the range through 12, specifying the index 
register. 

Table 4-3 lists the formats of index mode addressing. 

Examples 



REGISTER DEFERRED INDEX MODE 



OFFS=20 



MOVAB 

MOVL 

CLRB 



CLRQ 



BLIST,R9 
#0FFS,R1 
(R9) [Rl] 



(R9) [Rl] 



AUTOINCREMENT INDEX MODE 
CLRW (R9)+[R1] 



DEFINE OFFS 

GET ADDRESS OF BLIST 

SET UP INDEX REGISTER 

CLEAR BYTE WHOSE ADDRESS 

IS THE ADDRESS OF BLIST 

PLUS 20*1 

CLEAR QUADWORD WHOSE 

ADDRESS IS THE ADDRESS 

OF BLIST PLUS 20*8 



CLEAR WORD WHOSE ADDRESS 
IS ADDRESS OF BLIST PLUS 
20*2; R9 NOW CONTAINS 
ADDRESS OF BLIST+2 



AUTOINCREMENT DEFERRED INDEX MODE 



MOVAL 

MOVL 

CLRW 



POINT, R8 
#30, R2 
@(R8)+[R2] 



GET ADDRESS OF POINT 
SET UP INDEX REGISTER 
CLEAR WORD WHOSE ADDRESS 
IS 30*2 PLUS THE ADDRESS 
STORED IN POINT; R8 NOW 
CONTAINS 4 PLUS ADDRESS OF 
POINT 
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; DISPLACEMENT DEFERRED INDEX MODE 



MOVAL ADDARR,R9 
MOVL #100, Rl 
TSTF @40(R9) [Rl] 



GET ADDRESS OF ADDRESS ARRAY 
SET UP INDEX REGISTER 
TEST FLOATING POINT VALUE 
WHOSE ADDRESS IS 100*4 PLUS 
THE ADDRESS STORED AT (ADDARR+40) 



Table 4-3 
Index Mode Addressing 



Mode 


Format* 


Register Deferred Index 


(Rn) [Rx] 


Autoincrement Index 


(Rn)+[Rx] 


Autoincrement Deferred 
Index 


@(Rn)+[Rx] 


Autodecrement Index 


-(Rn) [Rx] 


Displacement Index 


dis(Rn) [Rx] 


Displacement Deferred 
Index 


@dis(Rn) [Rx] 


Relative Index 


address [Rx] 


Relative Deferred Index 


@address[Rx] 


Absolute Index 


@#address[Rx] 


General Index 


G~address [Rx] 



* Key: 
Rn 



Any general register R0 through R12 or the AP, FP, or SP 
register. 



RX 



Any general register R0 through R12 or the AP, FP, or SP 

register. Rx cannot be the same register as Rn in the 

autoincrement index, autoincrement deferred index, and 
decrement index addressing modes. 



dis 



An expression specifying a displacement. 



address 

An expression specifying an address, 
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Motes 

1. If the base mode alters the contents of its register 
(autoincrement, autoincrement deferred, and autodecreraent) , 
the index mode cannot specify the same register. 

2. The index register is added to the address after the base 
mode is completely evaluated. For example, in autoincrement 
deferred index mode, the base register contains the address 
of the operand address. The index register (times the length 
of the operand data type) is added to the operand address 
rather than to the address stored in the base register. 



4.4 BRANCH MODE 

In branch mode, the address is stored as an implied displacement from 
PC. This mode can only be used in branch instructions. The 
displacement for conditional branch instructions and the BRB 
instruction is stored in a byte. The displacement for the BRW 
instruction is stored in a word (2 bytes). A byte displacement allows 
a range of 127 bytes forward and 128 bytes backward. A word 
displacement allows a range of 32767 bytes forward and 32768 bytes 
backward. The displacement is relative to the updated PC, the byte 
past the byte or word where the displacement is stored. See the 
VAX-11/780 Architecture Handbook for more information on the branch 
instructions. 

Format 

address 

address 

An expression that represents an address. 



Example 

ADDL3 (R1)+,R0, TOTAL 

BLEQ LABEL1 

BRW LABEL 



TOTAL VALUES AND SET CONDITION 

CODES 

BRANCH TO LABEL1 IF RESULT IS 

LESS THAN OR EQUAL TO 

BRANCH UNCONDITIONALLY TO LABEL 
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CHAPTER 5 
GENERAL ASSEMBLER DIRECTIVES 



The general assembler directives provide facilities for performing 
eleven different types of functions. Table 5-1 lists these types of 
functions and the directives that fall under them. The remainder of 
this chapter describes the directives in detail, showing their formats 
and giving examples of their use. For ease of reference, the 
directives are presented in alphabetical order. In addition, Appendix 
B contains a summary of all assembler directives. 



Table 5-1 
Summary of General Assembler Directives 



Category 


Directives* 


Listing Control 
Directives 


.SHOW (.LIST) 

.NOSHOW (.NLIST) 

.TITLE 

.SUBTITLE (.SBTTL) 

. IDENT 

.PAGE 


Message Display 
Directives 


.PRINT 
.WARN 
. ERROR 


Assembler Option 
Directives 


. ENABLE ( . ENABL) 
.DISABLE (.DSABL) 
.DEFAULT 


Data Storage 
Directives 


.BYTE 

.WORD 

.LONG 

.ADDRESS 

.QUAD 

. PACKED 

.ASCII 

.ASCIC 

.ASCID 

.ASCIZ 

. FLOAT 

.DOUBLE 

.SIGNED BYTE 

.SIGNED WORD 



* The alternate form, 



if any, is given in parentheses. 

(continued on next page) 
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Table 5-1 (Cont.) 
Summary of General Assembler Directives 



Category 



Directives* 



Location Control 
Directives 



.ALIGN 

.EVEN 

.ODD 

.BLKA 

.BLKB 

.BLKD 

• BLKF 
.BLKL 
.BLKQ 
.BLKW 

• END 



Program 

Sectioning 

Directives 



. PSECT 

. SAVE_PSECT ( . SAVE) 

.RESTORE PSECT (.RESTORE) 



Symbol Control 

Directives 

Directives 



•GLOBAL (.GLOBL) 
.EXTERNAL (.EXTRN) 
. DEBUG 
• WEAK 



Routine Entry Point 

Definition 

Directives 



.ENTRY 

. TRANSFER 

.MASK 



Conditional 

and Subconditional 

Assembly 

Block Directives 



• IF 

.ENDC 

.IF FALSE (.IFF) 

.IF~TRUE (.IFT) 

•IF TRUE FALSE (.IFTF) 

.IIF 



Cr oss-Reference 
Directives 



Instruction 

Generation 

Directives 



.CROSS 
.NOCROSS 



.OPDEF 
.REF1 

• REF2 
.REF4 

• REF8 



The alternate form, if any, is given in parentheses. 
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.ADDRESS 

.ADDRESS — ADDRESS STORAGE DIRECTIVE 

.ADDRESS stores successive longwords containing addresses in the 
object module. DIGITAL recommends that .ADDRESS rather than .LONG be 
used for storing address data to provide additional information to the 
linker. In shareable images, addresses must be specified with 
.ADDRESS to produce position-independent code. 

Format 

.ADDRESS address-list 

Parameter 

address-list 

A list of symbols or expressions, separated by commas, that 
VAX-11 MACRO interprets as addresses. Repetition factors are not 
allowed. 

Example 

TABLE: .ADDRESS LAB 4, LAB 3,ROUTTERM ; REFERENCE TABLE 
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.ALIGN 



.ALIGN — LOCATION COUNTER ALIGNMENT DIRECTIVE 

•ALIGN aligns the location counter to the boundary specified by either 
an integer or a keyword. 



Formats 



.ALIGN integer [, expression] 
•ALIGN keyword [, expression] 



Parameters 
integer 



An integer in the range of through 9. The location counter is 
aligned at an address that is a multiple of 2 raised to the power 
of the integer. 



keyword 



One of five keywords that specify the alignment boundary. The 
location counter is aligned to an address that is the next 
multiple of the values listed below. 



Keyword 


Size (in Bytes) 


BYTE 


2*0 = 1 


WORD 


2~1 = 2 


LONG 


2*2 = 4 


QUAD 


2'3 = 8 


PAGE 


2~9 = 512 


expression 





Specifies the fill value to be stored in each byte. The 
expression must not contain any undefined symbols and must be an 
absolute expression (see Section 3.5). 



Example 



.ALIGN BYTE,0 

.ALIGN WORD 

.ALIGN 3, "A/ / 

.ALIGN PAGE 



BYTE ALIGNMENT-FILL WITH NULL 
WORD ALIGNMENT 

QUAD ALIGNMENT-FILL WITH BLANKS 
PAGE ALIGNMENT 



Notes 



The alignment specified in .ALIGN cannot exceed the alignment 
of the program section in which the alignment is attempted 
(see the description of .PSECT). For example, if the default 
program section alignment (BYTE) is being used and .ALIGN is 
specified with a WORD or larger alignment, the assembler 
displays an error message. 

If the optional expression is supplied, the bytes skipped by 
the location counter (if any) are filled with the value of 
that expression. Otherwise, the bytes are zero filled. 
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3. Although most instructions do not require any data alignment 
other than byte alignment, execution speed is improved by the 
following alignments: 

Data Length Alignment 

Word Word 

Longword Longword 
Quadword Quadword 
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.ASCIx 

ASCIx — ASCII CHARACTER STORAGE DIRECTIVES 

VAX-11 MACRO has four ASCII character storage directives: 

Directive Function 

ASCII ASCII string storage 

ASCIC Counted ASCII string storage 

ASCID String-descriptor ASCII string storage 

ASCIZ Zero-terminated ASCII string storage 

Each directive is followed by a string of characters enclosed in a 
pair of matching delimiters. The delimiters can be any printable 
character except the space, tab, equal sign (=) , semicolon (;), or 
left angle bracket (<) . The character used as the delimiter cannot 
appear in the string itself. Alphanumeric characters can be used as 
delimiters; however, nonalphanumeric characters should be used to 
avoid confusion. 

Any character except the null, carriage return, and form feed 
characters can appear within the string. The assembler does not 
convert lowercase alphabetic characters to uppercase. 

ASCII character storage directives convert the characters to their 
8-bit ASCII value (see Appendix A^ and store them one character to a 
byte. 

Any character, including the null carriage return, and form feed 
characters, can also be represented by an expression enclosed in angle 
brackets outside of the delimiters. The ASCII character storage 
directives store the 8-bit binary value specified by the expression. 

ASCII strings can be continued over several lines but the string on 
each line must be delimited at both ends; however, a different pair 
of delimiters can be used for each line. For example: 

CR=13 
LF=10 

.ASCII /ABC DEFG/ 

•ASCIZ @Any character can be delimiter^ 

.ASCIC ? lowercase is not converted to UPPER? 

.ASCII ? this is a test! ?<CRXLF>! Isn 't it?! 

•ASCII \ Angle Brackets Ore part <of> this> string \ 

•ASCII / This string is continued / - 

\ on the next line \ 

• ASCII <CRXLF>! this string includes an expression! - 

<128+CR>? whose value is a 13 plus 128? 

The following sections describe each of the four ASCII character 
storage directives, giving the formats and examples of each. 



5-6 



GENERAL ASSEMBLER DIRECTIVES 



.ASCII 



.ASCII — ASCII STRING STORAGE DIRECTIVE 

.ASCII stores in the next available byte the ASCII value of each 
character in the ASCII string or the value of each byte expression. 

Format 

.ASCII string 
Parameter 
string 

A delimited ASCII string. 
Example 

CR=13 
LF=10 

.ASCII "DATE: 17-NOV-1977" 
.ASCII /EOF/<CRXLF> 

.ASCIC 



.ASCIC ~ COUNTED ASCII STRING STORAGE DIRECTIVE 

.ASCIC performs the same function as .ASCII, except that .ASCIC 
inserts a count byte before the string data. The count byte contains 
the length of the string in bytes. The length given includes any 
bytes of nonprintable characters outside the delimited string but 
excludes the count byte. 

.ASCIC is useful in copying text because the count indicates the 
length of the text to be copied. 

Format 

.ASCIC string 
Parameter 
string 

A delimited ASCII string. 
Example 
CR=13 

.ASCIC #HELLO#<CR> 



.BYTE 6 

.ASCII #HELLO#<CR> 



THIS COUNTED ASCII STRING 

IS EQUIVALENT TO 

THE COUNT 

FOLLOWED BY TOE ASCII STRING 
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.ASCID 



.ASCID « STRING-DESCRIPTOR ASCII STRING STORAGE DIRECTIVE 

•ASCID performs the same function as ASCII, except that .ASCID inserts 
a string descriptor before the string data. 

The string descriptor consists of 1) two bytes of descriptor 
information, 2) two bytes that specify the length of the string, and 
3) a longword that points to the string. String descriptors are used 
in calling procedures (see Appendix C of the VAX-ll/78*0 Architecture 
Handbook ) . — — 

Format 

.ASCID string 
Parameter 
string 

A delimited ASCII string. 
Example 



DESCR1: .ASCID /ARGUMENT FOR CALL/ 
DESCR2: .ASCID /SECOND ARGUMENT/ 



; STRING DESCRIPTOR 
; ANOTHER ONE 



PUSHAL DESCR1 
PUSHAL DESCR2 
CALLS #2,STRNG PROC 



PUT ADDRESS OF DESCRIPTORS 
ON THE STACK 
CALL PROCEDURE 



.ASCIZ 

.ASCIZ « ZERO-TERMINATED ASCII STRING STORAGE DIRECTIVE 

.ASCIZ performs the same function as .ASCII, except that .ASCIZ 
appends a null byte as the final character of the string. Thus, when 
a list or text string is created with an .ASCIZ directive, the user 
need only perform a search for the null character in the last byte to 
determine the end of the string. 

Format 

•ASCIZ string 
Parameter 
string 

A delimited ASCII string. 
Example 
FF=12 



.ASCIZ /ABCDEF/ 
.ASCIZ /A/<FF>/B/ 



6 CHARACTERS IN STRING 

7 BYTES OF DATA 

3 CHARACTERS IN STRINGS 

4 BYTES OF DATA 
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.BLKx 

.BLKx ~ BLOCK STORAGE ALLOCATION DIRECTIVES 

VAX-11 MACRO has seven block storage directives: 

Directive Function 

.BLKA Reserves storage for addresses (longwords) 

.BLKB Reserves storage for byte data 

.BLKD Reserves storage for double-precision, 
floating-point data (quadwords) 

.BLKF Reserves storage for single-precision, 
floating-point data (longwords) 

.BLKL Reserves storage for longword data 

.BLKQ Reserves storage for quadword data 

.BLKW Reserves storage for word data 

Each directive reserves storage for a different data type. The value 
of the expression determines the number of data items for which VAX-11 
MACRO reserves storage. For example, .BLKL 4 reserves storage for 4 
longwords of data and .BLKB 2 reserves storage for 2 bytes of data. 

The total number of bytes reserved is equal to the length of the data 
type times the value of the expression as follows: 

Directive Number of Bytes Allocated 

.BLKB Value of expression 

.BLKW 2 * value of expression 

4 * value of expression 

8 * value of expression 




.BLKD! 


8 


.BLKQf 


Formats 




.BLKA 


expression 


.BLKB 


expression 


.BLKD 


expression 


.BLKF 


expression 


.BLKL 


expression 


.BLKQ 


expression 


.BLKW 


expression 


Parameter 




expression 





An expression specifying the amount of storage to be allocated. 
All the symbols in the expression must be defined and the 
expression must be an absolute expression (see Section 3.5). If 
the expression is omitted, a default value of 1 is assumed. 
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.BLKB 


15 


.BLKQ 


3 


.BLKL 


1 


.BLKF 


<3*4> 



SPACE FOR 15 BYTES 
SPACE FOR 3 QUADWORDS (24 BYTES) 
SPACE FOR 1 LONGWORD (4 BYTES) 
SPACE FOR 12 SINGLE PRECISION 
FLOATING-POINT VALUES (48 BYTES) 
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.BYTE 



.BYTE — BYTE STORAGE DIRECTIVE 

.BYTE generates successive bytes of binary data in the object module. 

Format 

.BYTE expression-list 
Parameter 
expression-list 

One or more expressions separated by commas. Each expression is 
first evaluated as a longword expression. Then the value of each 
expression is truncated to 1 byte. The value of each expression 
should be in the range of through 255 for unsigned data or in 
the range of -128 through +128 for signed data. 

Each expression optionally can be followed by a repetition factor 
delimited by square brackets. An expression followed by a 
repetition factor has the format: 

expression! [expression2] 

expressionl 

An expression that specifies the value to be stored. 

[expression2] 

An expression that specifies the number of times the value will 
be repeated. The expression must not contain any undefined 
symbols and must be an absolute expression (see Section 3.5). 
The square brackets are required. 



Example 



.BYTE <1024-1000>*2 

.BYTE ~XA,FIF,10,65-<21*3> 

. BYTE 

.BYTE X,X+3[5*4],Z 



STORES A VALUE OF 48 
STORES 4 BYTES OF DATA 
STORES 1 BYTE OF DATA 
STORES 22 BYTES OF DATA 



Notes 



1. 



2. 



The assembler displays an error message if the high-order 3 
bytes of the longword expression has a value other than or 
~XFFFFFF. 

At link time, a relocatable expression can result in a value 
that exceeds 1 byte. In this case, the VAX-11 Linker issues 
a truncation diagnostic message for the object module in 
question. For example: 



.BYTE A 



RELOCATABLE VALUE A WILL 
CAUSE VAX-11 LINKER TRUNCATION 
DIAGNOSTIC IF THE STATEMENT 
HAS A VIRTUAL ADDRESS OF 256 
OR ABOVE 
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3. The .SIGNED_BYTE directive is the same as .BYTE except the 

assembler displays a diagnostic message if a value in the 

range from 129 to 255 is specified. See the description of 
.SIGNED BYTE for more information. 
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.CROSS 
.NOCROSS 



.CROSS AND .NOCROSS — CROSS-REFERENCE DIRECTIVES 

VAX-11 MACRO produces a cross-reference listing when the CROSS 
qualifier is specified in the MACRO command. The .CROSS and .NOCROSS 
directives control which symbols are included in the cross-reference 
listing. The .CROSS and .NOCROSS directives have an effect only if 
/CROSS was specified in the MACRO command (see the VAX-11 MACRO User's 
Guide ) . 

By default, the cross-reference listing includes the definition and 
all the references to every symbol in the module. The cross-reference 
listing can be disabled for all symbols or for a specified list of 
symbols. 

.NOCROSS without a symbol list disables the cross-reference listing of 
all symbols. .CROSS without a symbol list reenables the 
cross-reference listing. Any symbol definition or reference that 
appears after .NOCROSS without a symbol list and before the next 
.CROSS without a symbol list is excluded from the cross reference 
listing . 



.NOCROSS with a symbol list disables the cross-reference listing 
the listed symbols. .CROSS with a symbol list reenables 
cross-reference listing of the listed symbols. 

Formats 

.CROSS 

.CROSS symbol -list 

. NOCROSS 

.NOCROSS symbol -list 

Parameter 

symbol -list 

A list of legal symbol names separated by commas. 
Examples 



for 

the 



LABI: 



. NOCROSS 

MOVL 

•CROSS 



LOCl,LOC2 



STOP CROSS REFERENCE 

COPY DATA 

REENABLE CROSS REFERENCE 



The definition of LABI and the references to LOCI 
included in the cross reference listing. 



and L0C2 are not 



LAB2; 



. NOCROSS 
MOVL 
. CROSS 



LOCI 

L0C1,L0C2 

LOCI 



DO NOT CROSS REFERENCE LOCI 
COPY DATA 

REENABLE CROSS REFERENCE 
OF LOCI 



The definition of LAB2 and the reference to LOC2 are included in the 
cross reference, but the reference to LOCI is not included in the 
cross reference. 
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Notes 

1. .CROSS without a symbol list will not reenable the 
cross-reference listing of a symbol specified in .NOCROSS 
with a symbol list. 

2. If the cross-reference listing of all symbols is disabled, 
.CROSS with a symbol list will have no effect until the 
cross-reference listing is reenabled by .CROSS without a 
symbol list. 
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.DEBUG 

.DEBUG — DEBUG SYMBOL ATTRIBUTE DIRECTIVE 

.DEBUG specifies that the symbols in the list are made known to the 
debugger. During an interactive debugging session, these symbols can 
be used to refer to memory locations or to examine the values assigned 
to the symbols. 

Format 

.DEBUG symbol -list 
Parameter 
symbol -list 

A list of legal symbols separated by commas. 

Example 

DEBUG INPUT, OUTPUT,- ; MAKE THESE SYMBOLS KNOWN 

LAB 30, LAB 40 ; TO THE DEBUGGER 



Note 



The assembler adds the symbols in the symbol list to the symbol 
table in the object module. The programmer need not specify 
global symbols in the .DEBUG directive because global symbols 
automatically are put in the object module's symbol table. See 
the description of .ENABLE for information on making information 
about all symbols available to the debugger. 
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.DEFAULT 

.DEFAULT — DEFAULT CONTROL DIRECTIVE 

i 

.DEFAULT determines the default displacement length for the relative 
and relative deferred addressing modes (see Sections 4.2.1 and 4.2.2). 

Format 

.DEFAULT DISPLACEMENT, keyword 
Parameter 
keyword 

One of three keywords— BYTE, WORD, LONG—indicating the default 
displacement length. 



Example 



.DEFAULT DISPLACEMENT, WORD 
MOVL LABEL, Rl 



•DEFAULT DISPLACEMENT, LONG 
INCB @COUNTS+4 



Notes 



WORD IS DEFAULT 
ASSEMBLER USES WORD 
DISPLACEMENT UNLESS 
LABEL HAS BEEN DEFINED 
LONG IS DEFAULT 
ASSEMBLER USES LONGWORD 
DISPLACEMENT UNLESS 
COUNTS HAS BEEN DEFINED 

1. .DEFAULT has no effect on the default displacement for 
displacement and displacement deferred addressing modes (see 
Sections 4.1.6 and 4.1.7). 

2. if there is no .DEFAULT in a source module, the default 
displacement length is a longword. 

.DISABLE 

.DISABLE — FUNCTION CONTROL DIRECTIVE 

.DISABLE disables, or inhibits, the specified assembler functions. 
See the description of .ENABLE for more information. 

Format 

•DISABLE argument-list 
Parameter 
argument-list 

One or more of the symbolic arguments listed in Table 5-2 in the 
description of .ENABLE. Either the long form or the short form 
of the symbolic arguments can be used. If multiple arguments are 
specified, they must be separated by commas, spaces, or tabs. 

Note 

The alternate form of .DISABLE is .DSABL. 
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.DOUBLE 



.DOUBLE — FLOATING POINT STORAGE DIRECTIVE 



.DOUBLE evaluates the specified floating-point constants and stores 
the results in the object module. .DOUBLE generates 64-bit, 
double-precision, floating-point data (1 bit of sign, 8 bits of 
exponent, and 55 bits of fraction). See the description of .FLOAT for 
information on storing single precision floating point numbers. 



Format 



.DOUBLE literal-list 



Parameter 



literal-list 



A list of floating-point constants (see Section 3.2.2). The 
constants cannot contain any unary or binary operators except 
unary plus or unary minus. 



Example 



.DOUBLE 1000,l.OE3,1.000000OE-9 
.DOUBLE 3.1415928, 1.107153423828 
.DOUBLE 5, 10, 15, 0, 0.5 



CONSTANT 
LIST 



Notes 



1. Double precision floating point numbers are always rounded. 
They are not effected by .ENABLE TRUNCATION. 

2. The floating point constants in the literal list must not be 
preceded by the floating point operator ("F) . 
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ENABLE 



.ENABLE — FUNCTION CONTROL DIRECTIVE 

•ENABLE enables the specified assembly function. .ENABLE and its 
negative form, .DISABLE, control the following assembler functions. 

• Creating local label blocks. 

• Making all local symbols available to the debugger and 
enabling the traceback feature. 

• Specifying that undefined symbol references are external 
references. 

• Truncating or rounding of single-precision, floating-point 
numbers. 

• Suppressing the listing of symbols that are defined but not 
referenced. 

• Specifying that all PC references are absolute not relative. 
Format 

.ENABLE argument-list 

Parameter 

argument-list 

One or more of the symbolic arguments listed in Table 5-2. 
Either the long form or the short form of the symbolic arguments 
can be used. 

If multiple arguments are specified, they must be separated by 
commas, spaces, or tabs. 



Table 5-2 
.ENABLE and .DISABLE Symbolic Arguments 



Long Form 



ABSOLUTE 



DEBUG 



Short Form 



AMA 



DBG 



Default 
Condition 



Disabled 



Disabled 



Function 



When ABSOLUTE is enabled, 
all PC relative addressing 
modes are assembled as 
absolute addressing modes. 

When DEBUG is enabled, all 
local symbols are included 
in the object module's 
symbol table for use by 
the debugger. 



(continued on next page) 
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Table 5-2 (Cont.) 
•ENABLE and .DISABLE Symbolic Arguments 



Long Form 



GLOBAL 



LOCAL BLOCK 



Short Form 



GBL 



LSB 



SUPPRESSION 



TRACEBACK 



TRUNCATION 



SUP 



Default 
Condition 



Enabled 



Disabled 



TBK 



FPT 



Disabled 



Enabled 



Function 



Disabled 



When GLOBAL is enabled, 
all undefined symbols are 
considered external 
symbols. When GLOBAL is 
disabled, any undefined 
symbol that is not listed 
in a .EXTERNAL directive 
causes an assembly error. 

When LOCAL BLOCK is 
enabled, tn*e current local 
label block is ended and a 
new one is started. When 
LOCAL_BLOCK is disabled, 
the current local label 
block is ended. See 
Section 3.4 for a complete 
description of local label 
blocks. 

When SUPPRESSION is 
enabled, all symbols that 
are defined but not 
referred to are not listed 
in the symbol table. When 
SUPPRESSION is disabled, 
all symbols that are 
defined are listed in the 
symbol table. 

When TRACEBACK is enabled, 
the program section names 
and lengths, module names, 
and routine names are 
included in the object 
module for use by the 
debugger. When TRACEBACK 
is disabled, VAX-11 MACRO 
excludes this information 
and, in addition, does not 
make any local symbol 
information available to 
the debugger. 

When TRUNCATION is 
enabled, floating-point 
numbers are truncated. 
When TRUNCATION is 
disabled, floating-point 
numbers are rounded. 
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Example 



■ENABLE ABSOLUTE, GLOBAL 



.DISABLE TRUNCATION, TRACEBACK 



Note 



; ASSEMBLE RELATIVE ADDRESS MODE 

; AS ABSOLUTE ADDRESS MODE. 

; UNDEFINED REFERENCES ARE GLOBAL 

; ROUND FLOATING-POINT NUMBERS. 

; DO NOT PUT ANY DEBUGGING 

7 INFORMATION INTO OBJECT MODULE 



The alternate form of .ENABLE is .ENABL. 
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.END 



.END — ASSEMBLY TERMINATION DIRECTIVE 



.END terminates the source program. No additional text should occur 
beyond this point in the current source file or in any additional 
source files specified in the command line for this assembly. If any 
additional text does occur, the assembler displays an error message 
and ignores the text. The additional text does not appear in either 
the listing file or the object file. 

Format 

.END [symbol] 

Parameter 



symbol 



The address (called the transfer address) at which program 
execution is to begin. 



Example 



ENTRY START. 



; ENTRY MASK 
; MAIN PROGRAM 



END 



START 



Notes 



The transfer address must be in a program section 
the EXE attribute (see the description of .PSECT). 



that has 



When an executable image consisting of several object modules 
is linked, only one object module should be terminated by an 
.END directive that specifies a transfer address. All other 
object modules should be terminated by .END directives that 
do not specify -a transfer address. If an executable image 
either contains no transfer address or contains more than one 
transfer address, the VAX-11 Linker displays an error 
message. 

If the source program contains an unterminated conditional 
code block when the .END directive is specified, the 
assembler displays an error message. 



.ENDC 



.ENDC — END CONDITIONAL DIRECTIVE 

.ENDC terminates the conditional range started by 
description of .IF for more information and examples. 



.IF. 



See the 



Format 



.ENDC 
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.ENTRY 



.ENTRY — ENTRY DIRECTIVE 

.ENTRY defines a symbolic name for an entry point and stores a 
register save mask (2 bytes) at that location. The symbol is defined 
as a global symbol with a value equal to the value of the location 
counter at the .ENTRY directive. The entry point can be used as the 
transfer address of the program. The register save mask is used to 
determine which registers are saved before the procedure is called. 
These saved registers are automatically restored when the procedure 
returns control to the calling program. See the description of the 
procedure call instructions in the VAX-11/780 Architecture Handbook . 

Format 



.ENTRY symbol, expression 
Parameter 
symbol 

The symbolic name for the entry point, 
expression 

The register save mask for the entry point. The expression must 
be an absolute expression and must not contain any undefined 
symbols. 



Example 



.ENTRY CALC,~M<R2,R3,R7> 



Notes 



PROCEDURE STARTS HERE. 
REGISTERS 2,3,7 ARE 
PRESERVED BY CALL AND 
RET INSTRUCTIONS 



1. The register mask operator (~M) is convenient to use for 
setting the bits in the register save mask (see Section 
3.6.2.2) • 

2. An assembly error occurs if the expression has bits 0, 1, 12, 
or 13 set. These bits correspond to the registers R0, Rl, 
AP, and FP and are reserved for the CALL interface. 

3. DIGITAL recommends that .ENTRY be used to define all callable 
entry points including the transfer address of the program. 
Although the following construct also defines an entry point, 
its use is discouraged: 

symbol:: .WORD expression 

Although a procedure starting with this construct can be 
called, the entry mask is not checked for any illegal 
registers and the symbol cannot be used in a .MASK directive. 
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4. .ENTRY should be used only for procedures that will be called 
by the CALLS or CALLG instruction. A routine that is entered 
by the BSB or JSB instruction should not use .ENTRY because 
these instructions do not expect a register save mask. These 
routines should begin in the following format: 

symbol:: first instruction 

The first instruction of the routine immediately follows the 
symbol . 
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.ERROR 



.ERROR — ERROR DIRECTIVE 

.ERROR causes the assembler to display an error message on the 
terminal or batch log file and in the listing file (if there is one). 

Format 

•ERROR [expression] ; comment 

Parameters 

expression 

An expression whose value is displayed when .ERROR is encountered 
during assembly. 

; comment 

A comment that is displayed when .ERROR is encountered during 
assembly. The comment must be preceded by a semicolon. 



Example 



.IF DEFINED 
.IF GREATER 
.ERROR 25 
• ENDC 
.ENDC 



LONG MESS 

1000-WORK_AREA 

; NEED LARGER WORK AREA 



If the symbol LONG_MESS is defined and if the symbol WORK AREA has 
value of 1000 or less, the following error message is displayed: 



%MACRO-E-GENERR, Generated ERROR: 25 NEED LARGER WORK AREA 



Notes 



1. .ERROR, .WARN, and .PRINT are called the message display 
directives. They can be used to display information 
indicating that a macro call contains an error or an illegal 
set of conditions (see Chapter 6 for more information on 
macro calls) . 

2. When the assembly is finished, the assembler displays the 
total number of errors and warnings and the sequence numbers 
of the lines causing the errors or warnings on the terminal. 
See the VAX-11 MACRO User's Guide for more information on 
errors and warnings. 

3. If .ERROR is included in a macro library (see the VAX-11 
M ACRO User's .Guide) , the comment should end with an 

Otherwise, the librarian will strip 
the comment from the directive and it will not be displayed 



additional semicolon* 

the comment 1 

when the macro is called ■. 



4. The line containing the -.ERROR directive is hot included in 
the listing file. 

5, If the expression has a value of 6, it is not displayed in 
the error message. 
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.EVEN 

.EVEN -- EVEN LOCATION COUNTER ALIGNMENT DIRECTIVE 

.EVEN ensures that the current value of the location counter is even 
by adding 1 if the current value is odd. If the current value is 
already even, no action is taken. 

Format 

.EVEN 



.EXTERNAL 



.EXTERNAL — EXTERNAL SYMBOL ATTRIBUTE DIRECTIVE 



.EXTERNAL indicates that specified symbols are external; that is, the 
symbols are defined in another object module and cannot be defined 
until link time (see Section 3.3.3). 

Format 

.EXTERNAL symbol -list 
Parameter 
symbol -list 

A list of legal symbols separated by commas. 
Example 

.EXTERNAL SIN, TAN, COS ; THESE SYMBOLS ARE DEFINED IN 
.EXTERNAL SINH,COSH,TANfH } EXTERNALLY ASSEMBLED MODULES 



Notes 



1. If the GLOBAL argument is enabled (see Table 5-2 in the 
description of .ENABLE), all unresolved references will be 
marked as global and external. Thus, if GLOBAL is enabled, 
the programmer need not specify .EXTERNAL. However, if 
GLOBAL is disabled, the programmer must explicitly specify 
.EXTERNAL to declare any Symbols that are defined externally 
but referred to irt the current module. 

2. If GLOBAL is disabled and the assembler finds symbols that 
are not defined in the current module and are not listed in a 
.EXTERNAL directive, the assembler displays art error message. 

3. The alternate form of .EXTERNAL is .EXTRN. 
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FLOAT 



.FLOAT — FLOATING-POINT STORAGE DIRECTIVE 

.FLOAT evaluates the specified floating-point constants and stores the 
results in the object module. .FLOAT generates 32-bit, 
single-precision, floating-point data (1 bit of sign, 8 bits of 
exponent, and 23 bits of fractional significance). See the 
description of .DOUBLE for information on storing double-precision 
floating-point numbers. 

Format 

.FLOAT literal -list 

Parameter 

literal-list 

A list of floating-point constants (see Section 3.2.2). The 
constants cannot contain any unary or binary operators except 
unary plus and unary minus. 

Example 



•FLOAT 134. 5782, 74218. 34E20 

.FLOAT 134.2,0.1342E3,1342E-1 

.FLOAT -0.75,lE38,-1.0E-37 

.FLOAT 0,25,50 



SINGLE PRECISION 

THESE ALL GENERATE 134.2 

DATA 

LIST 



Notes 



See the description of .ENABLE for information on specifying 
floating-point rounding or truncation. 



The floating point constants in the literal list must not 
preceded by the floating point unary operator (~F) . 



be 
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.GLOBAL 

.GLOBAL — GLOBAL SYMBOL ATTRIBUTE DIRECTIVE 

.GLOBAL indicates that specified symbol names are either globally 
defined in the current module or externally defined in another module 
(see Section 3.3.3). 

Format 

.GLOBAL symbol -list 
Parameter 
symbol -list 

A list of legal symbol names separated by commas. 
Example 

.GLOBAL LAB_40,LAB_30 
•GLOBAL UKN 13 



MAKE THESE SYMBOL NAMES 

GLOBALLY KNOWN 

TO ALL LINKED MODULES 



Notes 



1. .GLOBAL is provided for MACRO-11 compatibility only. DIGITAL 
recommends that global definitions be specified by a double 
colon or double equals sign (see Section 2.2.1 and 3.8) and 
that external references be specified by .EXTERNAL (when 
necessary) . 

2. The alternate form of .GLOBAL is .GLOBL. 
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.IDENT 

.IDENT — IDENTIFICATION DIRECTIVE 

•IDENT provides a means of identifying the object module. This 
identification is in addition to the name assigned to the object 
module with .TITLE. A character string can be specified in .IDENT to 
label the object module. This string is printed in the header of the 
listing file as well as appearing in the object module. 

Format 

.IDENT string 
Parameter 
string 

A 1- to 15-character string that identifies the module, such as a 
string that specifies a version number. The string must be 
delimited. The delimiters can be any paired printing characters, 
other than the left angle bracket (<) or the semicolon (;), as 
long as the delimiting character is not contained in the text 
string itself. 

Example 

•IDENT /3-47/ ; VERSION AND EDIT NUMBERS 

The character string 3-47 is included in the object module. 
Notes 

1. If one source module contains more than one .IDENT, the last 
directive given establishes the character string that forms 
part of the object module identification. 

2. If the delimiting characters do not match, or if an illegal 
delimiting character is used, the assembler displays an error 
message. 
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.IF 

.IF — CONDITIONAL ASSEMBLY BLOCK DIRECTIVES 

A conditional assembly block is a series of source statements that is 
assembled only if a certain condition is met. .IP starts the 
conditional block and .ENDC ends the conditional block. Each .IF must 
have a corresponding .ENDC. The .IF directive contains a condition 
test and one or two arguments. The condition test specified is 
applied to the argument (s) . If the test is met, all MACRO statements 
between .IF and .ENDC are assembled. If the test is not met, the 
statements are not assembled. An exception to this occurs when 
subconditional directives are used (see the description of . IF_x 
directive) . 

Conditional blocks can be nested, that is a conditional block can be 
inside of another conditional block. In this case the statements in 
the inner conditional block are assembled only if the condition is met 
for both the outer and inner block. 

Format 

.IF condition argument (s) 



range 

.ENDC 

Parameters 

condition 

A specified condition that must be met if the block is to be 
included in the assembly. Table 5-3 lists the conditions that 
can be tested by the conditional assembly directives. The 
condition must be separated from the argument (s) by a comma, 
space, or tab. 

argument (s) 

The symbolic argument (s) or expression (s) of the specified 
conditional test. If the argument is an expression, it cannot 
contain any undefined symbols and must be an absolute expression 
(see Section 3.5) . 



range 



The block of source code that is conditionally included in the 
assembly. 
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Table 5-3 
Condition Tests for Conditional Assembly Directives 



Condition 


Test 


Complement 
Condition Test 


Argument Type 


Number of 
Arguments 


Condition that 
Assembles Block 


Long 
Form 


Short 
Form 


Long Short 
Form Form 








EQUAL 


EQ 


NOT_EQ0AL NE 


Expression 




Expression is equal to 
(or not equal to 0) 


GREATER 


GT 


LESS_EQUAL LE 


Expression 




Expression is greater 
than (or less than 
or equal to 0) 


LESSJTHAN 


LT 


GREATER_EQUAL GE 


Expression 




Expression is less 
than (or greater 
than or equal to 0) 


DEFINED 


DF 


NOT_DEFINED NDF 


Symbol ic 




Symbol is defined (or 
not defined) 


BLANK* 


B 


NOT_BLANK* NB 


Macro 




Argument is blank (or 
nonblank) 


IDENTICAL* 


IDN 


DIFFERENT* DIP 


Macro 


2 


Arguments are 
identical (or 
different) 



* The BLANK, NOT BLANK, IDENTICAL, and DIFFERENT conditions are only 
useful in macro 3ef initions. Chapter 6 describes macro directives in 
detail . 



Examples 

1. An example of a conditional assembly directive is: 



.IF EQUAL ALPHA+1 



; ASSEMBLE BLOCK IP ALPHA+1=0 

; DO NOT ASSEMBLE IF ALPHA+1 NOT=0 



• ENDC 

2. Nested conditional directives take the form: 

•IF condition, argument (s) 
•IF condition, argument (s) 



.ENDC 
.ENDC 
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3. The following conditional directives can govern whether 
assembly is to occur: 

.IF DEFINED SYMl 
.IF DEFINED SYM2 



.ENDC 
• ENDC 

In this example, if the outermost condition is not satisfied, no 
deeper level of evaluation of nested conditional statements within the 
program occurs. Therefore, both SYMl and SYM2 must be defined for the 
code to be assembled. 



Notes 



1. If .ENDC occurs outside a conditional assembly block, the 
assembler displays an error message. 

2. VAX-11 MACRO permits a nesting depth of 31 conditional 
assembly levels. If a statement attempts to exceed this 
nesting level depth, the assembler displays an error message. 

3. The assembler displays an error message if .IF specifies any 
of the following: a condition test other than those in Table 
5-3, an illegal argument, or a null argument specified in an 
.IF directive. 

4. The .SHOW and .NOSHOW directives control whether condition 
blocks that are not assembled are included in the listing 
file. 
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.IF_x 

.IF_x — SUBCONDITIONAL ASSEMBLY BLOCK DIRECTIVES 

VAX-11 MACRO has three subconditional assembly block directives: 

Directive Function 

.IF_FALSE If the condition of the assembly block tests 
false, the program is to include the source code 
following the . IF_FALSE directive and continuing 
up to the next subconditional directive or to the 
end of the conditional assembly block. 

.IF_TRUE If the condition of the assembly block tests true, 
the program is to include the source code 
following the . IF_TRUE directive and continuing up 
to the next subconditional directive or to the end 
of the conditional assembly block. 

. IF_TRUE_FALSE Always include the source code following the 
. IF_TRUE_FALSE directive and continuing up to the 
next subconditional directive or to the end of the 
conditional assembly block. This source code is 
included regardless of whether the condition of 
the assembly block tests true or false. 

The implied argument of a subconditional directive is the condition 
test specified when the conditional assembly block was entered. A 
conditional or subconditional directive in a nested conditional 
assembly block is not evaluated if the preceding (or outer) condition 
in the block is not satisfied (see examples 3 and 4 below) . 

A conditional block with a subconditional directive is different than 
a nested conditional block. If the condition in the .IF is not met, 
the inner conditional block (s) are not assembled, but a subconditional 
directive can cause a block to be assembled. 

Formats 

. IF_FALSE 

.IF TRUE 

. IF~TRUE_FALSE 

Exampl es 

1. Assume that symbol SYM is defined: 



.IF DEFINED 



IF FALSE 



SYM 



IF TRUE 



TESTS TRUE SINCE SYM IS DEFINED. 
ASSEMBLES THE FOLLOWING CODE. 



TESTS FALSE SINCE PREVIOUS 
.IF WAS TRUE. DO NOT 
ASSEMBLE THE FOLLOWING CODE. 



TESTS TRUE. SYM IS DEFINED. 
ASSEMBLES THE FOLLOWING CODE. 
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IF TRUE FALSE 



ASSEMBLES FOLLOWING CODE 
UNCONDITIONALLY. 



IF TRUE 



TESTS TRUE. SYM IS DEFINED. 
ASSEMBLES REMAINDER OF 
CONDITIONAL ASSEMBLY BLOCK. 



.ENDC 

Assume that symbol X is defined and that symbol Y is not defined: 



.IF DEFINED 
.IF DEFINED 

•IF FALSE 



IF TRUE 



X 
Y 



TESTS TRUE. SYMBOL X IS DEFINED. 

TESTS FALSE. SYMBOL Y IS NOT 

DEFINED. 

TESTS TRUE. SYMBOL Y IS NOT 

DEFINED. 

ASSEMBLES THE FOLLOWING CODE. 



TESTS FALSE. SYMBOL Y IS NOT 

DEFINED. 

DOES NOT ASSEMBLE THE FOLLOWING 

CODE. 



.ENDC 
.ENDC 



3. Assume that symbol A is defined and that symbol B is not defined: 



, IF DEFINED A 



; TESTS TRUE. A IS DEFINED. 

; ASSEMBLES THE FOLLOWING CODE. 



IF FALSE 



; TESTS FALSE. A IS DEFINED. DOES 
; NOT ASSEMBLE THE FOLLOWING CODE. 



IF NOT DEFINED B 



NESTED CONDITIONAL DIRECTIVE 
IS NOT EVALUATED. 



.ENDC 
• ENDC 



4. Assume that symbol X is not defined but symbol Y is defined: 



.IF DEFINED 



IF DEFINED Y 



TESTS FALSE. SYMBOL X IS NOT 

DEFINED. 

DOES NOT ASSEMBLE THE 

FOLLOWING CODE. 

NESTED CONDITIONAL DIRECTIVE 

IS NOT EVALUATED. 



IF FALSE 



NESTED SUBCONDITIONAL 
DIRECTIVE IS NOT EVALUATED. 
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.IF TRUE 



; NESTED SUBCONDITIONAL 

; DIRECTIVE IS NOT EVALUATED. 



Note 



.ENDC 
.ENDC 



1. 



2. 



If a subconditional directive appears outside a conditional 
assembly block, the assembler displays an error message. 



The alternate forms 
•IF TRUE FALSE are .IFF, 



of .IF_FALSE, 
. IFT, and .IFTF. 



.IF TRUE, 



and 
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.IIF 

.IIP — IMMEDIATE CONDITIONAL ASSEMBLY BLOCK DIRECTIVE 

•IIF provides a means of writing a one-line conditional assembly 
block. The condition to be tested and the conditional assembly block 
are expressed completely within the line containing the .IIF 
directive; no terminating .ENDC statement is required. 

Format 

.IIF condition argument (s), statement 

Parameters 

condition 

One of the legal condition tests defined for conditional assembly 
blocks in Table 5-3 (See the description of .IF). The condition 
must be separated from the argument (s) by a comma, space, or tab. 

argument (s) 

The argument associated with the immediate conditional directive; 
that is, an expression or symbolic argument (described in Table 
5-3). If the argument is an expression, it cannot contain any 
undefined symbols and must be an absolute expression (see Section 
3.3.3). The argument (s) must be separated from the statement by 
a comma. 

statement 

The statement to be assembled if the condition is satisfied. 

Example 

Condition Argument Statement 

•IIF DEFINED EXAM, BEQL ALPHA 

This directive generates the following code if the symbol EXAM is 
defined within the source program: 

BEQL ALPHA 

Note 

The assembler displays an error message if .IIF specifies any of 
the following: a condition test other than those listed in Table 
5-3, an illegal argument, or a null argument. 
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.LIST 

.LIST — LISTING DIRECTIVE 

.LIST is equivalent to the .SHOW. See the description of .SHOW for 
more information. 



Formats 



.LIST 
LIST argument-list 



Parameter 

argument-list 



One or more of the symbolic argument defined in Table 5-7 in the 
description of .SHOW. Either the long form or the short form of 
the arguments can be used. If multiple arguments are specified, 
they must be separated by commas, spaces, or tabs. 



5-36 



GENERAL ASSEMBLER DIRECTIVES 

.LONG 

.LONG — LONGWORD STORAGE DIRECTIVE 

•LONG generates successive longwords of data in the object module. 

Format 

.LONG expression-list 

Parameters 

expression-list 

One or more expressions separated by commas. Each expression 
optionally can be followed by a repetition factor delimited by 
square brackets. 

An expression followed by a repetition factor has the format: 
expressionl [expression2] 
expressionl 

An expression that specifies the value to be stored. 

[expression2] 

An expression that specifies the number of times the value will 
be repeated. The expression must not contain any undefined 
symbols and must be an absolute expression (see Section 3.5). 
The square brackets are required. 



Example 

LAB_3: .LONG LAB 3, ^XTFFFFFFFf'A'ABCD' 

.LONG ~XF?4 

.LONG 0[22] 



3 LONGWORDS OF DATA 
1 LONGWORD OF DATA 
22 LONGWORDS OF DATA 



Note 



Each expression in the list must have a value that can be 
represented in 32 bits. 
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.MASK 

.MASK — MASK DIRECTIVE 

.MASK reserves a word for a register save mask for a transfer vector. 
See the description of .TRANSFER for more information and for an 
example of .MASK. 

Format 

.MASK symbol [, expression] 
Parameters 
symbol 

A symbol defined in an .ENTRY directive, 
expression 

A register save mask. 
Notes 

1. If .MASK does not contain an expression, the assembler directs 
the linker to copy the register save mask specified in .ENTRY to 
the word reserved by .MASK. 

2. If .MASK contains an expression, the assembler directs the linker 
to combine this expression with the register save mask specified 
in .ENTRY and store the result in the word reserved by .MASK. 
The linker performs an inclusive OR operation to combine the mask 
in the entry point and the value of the expression. 
Consequently, a register specified in either .ENTRY or .MASK will 
be included in the combined mask. See the description of .ENTRY 
for more information on entry masks. 

.NLIST 

.NLIST -- LISTING DIRECTIVE 

.NLIST is equivalent to .NOSHOW. See the description of .SHOW for 
more information. 



Formats 



.NLIST 

.NLIST argument-list 



Parameter 
argument-list 



One or more of the symbolic arguments listed in Table 5-7 in the 
description of .SHOW. Either the long form or the short form of 
the arguments can be used. If multiple arguments are specified, 
they must be separated by commas, spaces, or tabs. 
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.NOCROSS 

.NOCROSS — CROSS REFERENCE DIRECTIVE 

VAX-11 MACRO produces a cross-reference listing when the CROSS 
qualifier is specified in the MACRO command. The .CROSS and .NOCROSS 
directives control which symbols are included in the cross-reference 
listing. The description of .NOCROSS is included with the description 
of .CROSS. 

.NOSHOW 



.NOSHOW -- LISTING DIRECTIVE 

.NOSHOW specifies listing control options. See the description of 
.SHOW for more information. 



Formats 



• SHOW 

.SHOW argument-list 



Parameter 

argument-list 

One or more of the symbolic arguments listed in Table 5-7 in the 
description of .SHOW. Either the long form or the short form of 
the arguments can be used. If multiple arguments are specified, 
they must be separated by commas, spaces, or tabs. 

.ODD 

•ODD — ODD LOCATION COUNTER ALIGNMENT DIRECTIVE 

.ODD ensures that the current value of the location counter is odd by 
adding 1 if the current value is even. If the current value is 
already odd, no action is taken. 

Format 

• ODD 
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OPDEF 



.OPDEP — OPCODE DEFINITION DIRECTIVE 

.OPDEF defines an opcode, which it inserts into a user-defined opcode 
table. The assembler searches this table before it searches the 
permanent symbol table. This directive can redefine an existinq 
opcode name or create a new one. 

Format 



.OPDEF opcode 
Parameters 



value, operand -descr iptor-1 i st 



opcode 



An ASCII string specifying the name of the opcode. The string 
can be up to 15 characters long and can contain the letters A 
through Z; the digits through 9; and the special characters 
underline (), dollar sign ($) , and period (.). The string 
should not start with a digit and should not be surrounded bv 
delimiters. 2 



value 

An expression that specifies the value of the opcode. The 
expression must not contain any undefined values and must be an 
absolute expression (see Section 3.5). The value of the 
expression must be in the range of through decimal 65535 
(hexadecimal FFFF) . 

operand-descriptor-list 

A list of operand descriptors tnat specifies the number of 
operands and the type of each. Up to 16 operand descriptors are 
allowed in the list. Table 5-4 lists the operand descriptors. 

Table 5-4 
Operand Descriptors 



Access 
Type 




Data Type 


Byte 


Word 


Long- 
word 


Floating 
Point 


Double 

Floating 

Point 


Quad- 
word 


Address 


AB 


AW 


AL 


AF 


AD 


AQ 


Read-only 


RB 


RW 


RL 


RF 


RD 


RQ 


Modify 


MB 


MW 


ML 


MF 


MD 


MQ 


Write-only 


WB 


WW 


WL 


WF 


WD 


WQ 


Field 


VB 


VW 


VL 


VF 


VD 


VQ 


j Branch 


BB 


BW 


- 


- 


- 


- 
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Examples 



.OPDEF MOVL3 



.OPDEF DIVF2 
.OPDEF MOVC5 
, OPDEF CALL 



*XFFA9,RL,ML,WL ; DEFINES AN 

; INSTRUCTION, MOVL3, WHICH USES 
; THE RESERVED OPCODE FF. 

*X46,RF,MF ; REDEFINES THE DIVF2 AND 

*X2C,RW,AB,AB,RW,AB • ; MOVC5 INSTRUCTIONS. 

*X10,BB ; EQUIVALENT TO A BSBB 



Notes 



1. 



2. 



3. 



A macro can also be used to redefine an opcode (see the 
description of .MACRO in Chapter 6). Note that the macro 
name table is searched before the user-defined opcode table. 

.OPDEF is useful in creating "custom" instructions that 
execute user-written microcode. Note that DIGITAL does not 
support or provide tools for user-written microcode. This 
directive is supplied to allow programmers who have developed 
tools and written microcode to execute their microcode in a 
MACRO program. 

The operand descriptors are specified in a format similar to 
the operand specifier notation described in the VAX-11/780 
Architecture Handbook . The first character specifies the 
operand access type and the second character specifies the 
operand data type. 
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.PACKED 

. PACKED — PACKED DECIMAL STRING STORAGE DIRECTIVE 

.PACKED generates packed decimal data, 2 digits per byte. Packed 
decimal data is useful in calculations requiring exact accuracy. 
Packed decimal data is operated on by the decimal string instructions. 
See the VAX-11/780 Architecture Handbook for more information on the 
format of packed decimal data. 

Format 

.PACKED dec imal -str ing [, symbol] 
Parameters 
decimal-string 

A decimal number from through 31 digits long with an optional 
sign. Each digit can be in the range of 0- through 9 (see Section 
3.2.3). 



symbol 



An optional symbol that is assigned a value equivalent to the 
number of decimal digits in the string. The sign is not counted 
as a digit. 



Example 



.PACKED -12, PACK SIZE ; PACK SIZE GETS VALUE OF 2 

.PACKED +500 

•PACKED 

.PACKED -0,SUM_SIZE ; SUM_SIZE GETS VALUE OF 1 

.PAGE 

.PAGE — PAGE EJECTION DIRECTIVE 

.PAGE forces a new page in the listing; the directive itself is not 
printed in the listing. 

VAX-11 MACRO ignores .PAGE in a macro definition. The paging 
operation is performed only during macro expansion. Chapter 6 
describes macro directives and facilities in detail. 

Format 

.PAGE 
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.PRINT 

.PRINT « ASSEMBLY MESSAGE DIRECTIVE 

.PRINT causes the assembler to display an informational message. The 
message consists of the value of the expression and the comment 
specified in the .PRINT directive. The message is displayed on the 
terminal for interactive jobs and in the log file for batch jobs. The 
message produced by .PRINT is not considered an error or warning 
message. 

Format 

•PRINT [expression] ;comment 

Parameters 

expression 

An expression whose value is displayed when .PRINT is encountered 
during assembly. 

comment 

A comment that is displayed when .PRINT is encountered during 
assembly. The comment must be preceded by a semicolon. 



Example 



.PRINT 2 ; THE SINE ROUTINE HAS BEEN CHANGED 



Notes 



1. .PRINT, .ERROR, and .WARN are called the message display 
directives. They can be used to display information 
indicating that a macro call contains an error or an illegal 
set of conditions (See Chapter 6 for more information on 
macro calls) . 

2. If .PRINT is included in a macro library (see the VAX- 11 
MACRO User's Guide ) , the comment should end with an 
additional semicolon. Otherwise, the comment will be 
stripped from the directive and will not be displayed when 
the macro is called. 

3. If the expression has a value of 0, it is not displayed with 
the message. 
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.PSECT 

.PSECT ~ PROGRAM SECTIONING DIRECTIVE 

•PSECT defines a program section and its attributes and refers to a 
program section once it is defined. 

Program sections can be used to: 

• Develop modular programs 

• Separate instructions from data 

• Allow different modules to access the same data 

• Protect read-only data and instructions from being modified 

• Identify sections of the object module to the debugger 

• Control the order in which program sections are stored in 
virtual memory 

See the VAX-11 MACRO User's Guide for more information on using 
program sections. 

When the assembler encounters a .PSECT directive that specifies a new 
program section name, it creates a new program section and stores the 
name, attributes, and alignment of the program section. The assembler 
includes all data and instructions that follow the .PSECT directive in 
that program section until it encounters another .PSECT directive. 
The assembler starts all program sections at a location counter of 
relocatable 0. 

If the assembler encounters a .PSECT directive that specifies the name 
of a previously defined srogram section, it stores the new data or 
instructions so that they logically follow the last entry in the 
previously defined program section. Specifically, the location 
counter is set to the value of the location counter at the end of the 
previously defined program section. The programmer need not list the 
attributes when continuing a program section but any attributes that 
are listed must be the same as those previously listed for the program 
section. 

The assembler automatically defines two program sections: the 
absolute program section and the unnamed (or blank) program section. 
Any symbol definitions that appear before any instruction, data, or 
.PSECT directive are placed in the absolute program section. Any 
instructions or data that appear before the first named program 
section is defined are placed in the unnamed program section. Any 
•PSECT directive that does not include a program section name 
specifies the unnamed program section. 

A maximum of 254 user-defined, named program sections can be defined. 

The attributes listed in the .PSECT directive only describe the 
contents of the program section. The assembler does not check to 
ensure that the contents of the program section actually include the 
attributes listed. 

However, the assembler and the linker do check that all program 

sections with the same name have exactly the same attributes. The 

assembler and linker display an error message if the program section 
attributes are not consistent. 
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Program section names are independent of local symbol, global symbol, 
and macro names. Thus, the same symbolic name can be used for a 
program section and for a local symbol, global symbol, or macro name. 

Formats 

.PSECT 

.PSECT program-section-name [, argument-list] 



Parameters 

program-section-name 

The name of the program section. This name can be up to 15 
characters long and can contain any alphanumeric character and 
the underline ( ), dollar sign ($) , and period (.) characters. 
However, the first character must not be a digit in the range of 
through 9. 



argument-list 

A list co 
section 
functions 
opposites 
range of 
keywords 
the progr 
address 
integer . 
linked to 
the value 

Keyword 

BYTE 
WORD 
LONG 
QUAD 
PAGE 



ntaining the prog 
alignment. Tabl 
. Table 5-6 list 
Program sect 
through 9 is 

listed below is 

am section is li 

that is a mult 

If a keyword is 

begin at the nex 

s listed below: 



ram section attributes and the program 
e 5-5 lists the attributes and their 
s the default attributes and their 
ions are aligned when an integer in the 
specified or when one of the five 
specified. If an integer is specified, 
nked to begin at the next virtual 
iple of 2 raised to the power of the 
specified, the program section is 
t virtual address that is a multiple of 



Size (in Bytes) 



2"0 
2~1 
2~2 
2~3 
2*9 



1 
2 
4 
8 
512 



BYTE is the default. 



Table 5-5 
Program Section Attributes 



Attribute 

Name 



Function 



ABS 



Absolute — The linker assigns the program section an 
absolute address. The contents of the program section 
can be only symbol definitions (usually definitions of 
symbolic offsets to data structures that are used by 
the routines being assembled) . An absolute program 
section contributes no binary code to the image, so its 
byte allocation request to the linker is 0. The size 
of the data structure being defined is the size of the 
absolute program section printed in the "program 
section synopsis" at the end of the listing. Compare 
this attribute with its opposite, REL. 



(continued on next page) 
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Attribute 
Name 



CON 



EXE 



GBL 



LCL 

LIB 

NOEXE 

NOPIC 

NORD 
NOSHR 

NOWRT 

OVR 
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Table 5-5 (Cont.) 
Program Section Attributes 



Function 



Concatenate — Program sections with the same name and 
attributes (including CON) are merged into one program 
section. Their contents are merged in the order in 
which the linker acquires them. The allocated virtual 
address space is the sum of the individual requested 
allocations. 

Executable — The program section contains instructions. 
This attribute provides the capability of separating 
instructions from read-only and read/write data. The 
linker uses this attribute in gathering program 
sections and in verifying that the transfer address is 
in an executable program section. 

Global — Program sections that have the same name and 
attributes, including GBL and OVR, will have the same 
relocatable address in memory even when the program 
sectibns are in different clusters (see the VAX- 11 
Linker Reference Manual for more information on 
clusters) . This attribute is specified for FORTRAN 
COMMON block program sections (see the VAX-11 FORTRAN 
IV-PLOS User's Guide ) . Compare this attribute with its 
opposite, LCL. 

Local — The program section is restricted to its 
cluster. Compare this attribute with its opposite, 
GBL. 

Library Segment — Reserved for future use. 

Not Executable — The program section contains data only; 
it does not contain instructions. 

Non-Position-Independent Content — The program section 
is assigned to a fixed location in virtual memory (when 
it is in a shareable image) . 

Nonreadable — Reserved for future use. 

No Share — The program section is reserved for private 
use at execution time by the initiating process. 

Nonwritable — The program section's contents cannot be 
altered (written into) at execution time. 

Overlay — Program sections with the same name and 
attributes, including OVR, have the same relocatable 
base address in memory. The allocated virtual address 
space is the requested allocation of the largest 
overlaying program section. Compare this attribute 
with its opposite, CON. 



(continued on next page) 
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Table 5-5 (Cont.) 
Program Section Attributes 



Attribute 
Name 



Function 



PIC 

RD 
REL 

SHR 

USR 
WRT 



Position-Independent Content — The program section can 
be relocated; that is, it can be assigned to any 
memory area (when it is in a shareable image) . 

Readable — Reserved for future use. 

Relocatable — The linker assigns the program section a 
relocatable base address. The contents of the program 
section can be code or data. Compare this attribute 
with its opposite, ABS. 

Share — The program section can be shared at execution 
time by multiple processes. This attribute is assigned 
to a program section that can be linked into a 
shareable image. 

User Segment — Reserved for future use. 

Write — The program section's contents can be altered 
(written into) at execution time. 



Table 5-6 
Default Program Section Attributes 



Default 


Opposite 


Attribute 


Attribute 


CON 


OVR 


EXE 


NOEXE 


LCL 


GBL 


NOPIC 


PIC 


NOSHR 


SHR 


RD 


NORD 


REL 


ABS 


WRT 


NOWRT 



Examples 



.PSECT CODE, NOWRT, EXE, LONG 
.PSECT RWDATA, WRT, NOEXE, QUAD 



; PROGRAM SECTION TO CONTAIN 
; EXECUTABLE CODE 

; PROGRAM SECTION TO CONTAIN 
; MODIFIABLE DATA 
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Notes 



1. The .ALIGN directive cannot specify an alignment greater than 
that of the current program section; consequently, .PSECT 
should specify the largest alignment needed in the program 
section. For efficiency of execution, an alignment of 
longword or larger is recommended for all program sections 
that have longword data. 

2. The attributes of the default absolute and the default 
unnamed program sections are listed below. Note that the 
program section names include the periods and enclosed 
spaces. 

Program Section 

Name Attributes and Alignment 

• ABS . NOPIC,USR, CON, ABS,LCL,NOSHR,NOEXE,NORD,NOWRT, BYTE 

. BLANK . NOPIC,USR, CON, REL,LCL,NOSHR,NOEXE,RD,WRT, BYTE 
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.QUAD 



.QUAD — QDADWORD STORAGE DIRECTIVE 

•QUAD generates 64 bits (8 bytes) of binary data. 

Format 

.QUAD literal 
.QUAD symbol 

Parameters 



literal 



Any constant value. This value can be preceded by "0, ~B, X, or 
"D to specify the radix as octal, binary, hexadecimal, or 
decimal, respectively; or it can be preceded by "A to specify 
the ASCII text operator. Decimal is the default radix. 



symbol 



A symbol defined somewhere in the program. This symbol results 
in a sign-extended, 32-bit value being stored in a quadword. 



Example 



• QUAD 

.QUAD 

• QUAD 
.QUAD 
.QUAD 



"A 1 .. ASK?.. ' 



"X0123456789ABCDEF 
"BllllOOOlllOOllOl 
LABEL 



EACH ASCII CHARACTER IS STORED 

IN A BYTE 

QUAD 

QUAD HEX VALUE SPECIFIED 

QUAD HEX VALUE SPECIFIED 

LABEL HAS A 32 BIT 

VALUE ZERO EXTENDED. 



Note 



.QUAD is different from other data storage directives (.BYTE, 
.WORD, and .LONG) in that it does not evaluate expressions and 
that it accepts only one value. It does not accept a list. 
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REFn 



.REPn — OPERAND GENERATION DIRECTIVES 

vax-11 MACRO has four operand storage directives used in macros (see 
Chapter 6) to define new opcodes: 



Directive 

REF1 

REF2 

REF4 

REF8 



Function 

Generates a byte operand 
Generates a word operand 
Generates a longword operand 
Generates a quadword operand 



•REFn is provided for compatibility with VAX-11 MACRO VI. 0. .OPDEF 
provides greater functionality and is easier to use than .REFn; 
consequently, .OPDEF should be used instead of .REFn. 

Formats 

.REF1 operand 

.REF2 operand 

•REF4 operand 

•REF8 operand 

Parameter 

operand 



An operand of byte, word, longword, or quadword 
respectively. 



context, 



Example 



.MACRO MOVL3 A,B,C 

•BYTE ~XFF,~XA9 

.REF4 A 

.REF4 B 

.REF4 C 

. ENDM MOVL3 



; THIS OPERAND HAS LONGWORD CONTEXT 
i j THIS OPERAND HAS LONGWORD CONTEXT 
: ; THIS OPERAND HAS LONGWORD CONTEXT 



MOVL3 R0,@LAB-1, (R7)+[R10] 

This example uses .REF4 to create a new instruction, MOVL3, which uses 
the reserved opcode FF. See the example in .OPDEF for a preferred 
method to create a new instruction. 
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.RESTORE_PSECT 



.RESTORE PSECT — RESTORE PREVIOUS PROGRAM SECTION CONTEXT DIRECTIVE 

•RESTORE PSECT retrieves the program section from the top of the 
program section context stack, an internal stack in the assembler. If 
the stack is empty when .RESTORE_PSECT is issued, the assembler 
displays an error message. When . RESTORE_PSECT retrieves a program 
section, it restores the current location counter to the value it had 
when the program section was saved. The local label block is also 
restored if it was saved when the program section was saved. 



Format 



.RESTORE PSECT 



Example 



.SAVE PSECT and .RESTORE_PSECT are useful in macros that define 
program sections (see Chapter 6) . The macro definition below 
saves the current program section context and defines new program 
sections. Then, it restores the saved program section. If the 
macro did not save and restore the program section context each 
time the macro was invoked, the program section would change. 



.MACRO INITD 



.SAVE PSECT 


•PSECT 


SYMBOLS, ABS 


HELP LEV=2 




MAXNUM=100 




RATE 1=1 6 




RATE 2= 4 




•PSECT 


DATA,NOEXE,LONG 


TABL: .BLKL 


100 


TEMP: .BLKB 


16 



.RESTORE PSECT 



• ENDM 



INITIALIZE SYMBOLS 
AND DATA AREAS 
SAVE. THE CURRENT PSECT 
DEFINE NEW PSECT 
DEFINE SYMBOLS 



DEFINE ANOTHER PSECT 
100 LONGWORDS IN TABL 
MORE STORAGE 
RESTORE THE PSECT 
IN EFFECT WHEN 
MACRO IS INVOKED 



Note 



The alternate form of .RESTORE PSECT is .RESTORE. 
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.SAVE_PSECT 



.SAVE_PSECT — SAVE CURRENT PROGRAM SECTION CONTEXT DIRECTIVE 

.SAVE_PSECT stores the current program section context on the top of 
the program section context stack, an internal assembler stack, while 
leaving the current program section context in effect. 

.SAVE_PSECT and . RESTORE_PSECT are useful in macros that define 
program sections (see Chapter 6) . See the description of 
. RESTORE_PSECT for another example using .SAVE PSECT. 

Format 

. SAVE_PSECT [ LOCAL_BLOCK] 
Parameter 
LOCAL BLOCK 



An optional keyword that specifies that the current 
is to be saved with the program section context. 



local label 



Example 

PROGRAM_START: : .WORD 

BLBC R0,20$ 
%MACRO-E-UNDEFSYMBOL, Undefined symbol 



, SAVE_PSECT 

, PSECT STRINGS 



PNTR 



.ASCII /SOME ASCII TEXT/ 
.RESTORE PSECT 



MOVAB W~PNTR,R0 
BSBW PRINT IT 
20$: RSB ~ 



; THIS TIME USING ,SAVE_PSECT LOCAL BLOCK 
OTHER_LABEL: I 

BLBC R0,20$ 

. SAVE_PSECT LOCAL_BLOCK 
.PSECT STRINGS 



THIS CREATES LOCAL LABEL BLOCK 
BRANCH IS LOW BIT CLEAR 
i 

THIS WILL GENERATE AN ERROR 

SINCE THE DEFINITION FOR 20$ 

IS IN A DIFFERENT LOCAL 

LABEL BLOCK 

SAVE CURRENT PSECT NUMBER 

SWITCH TO NEW PSECT 

THIS ALSO CREATES NEW LOCAL 

LABEL BLOCK 

SET POINTER TO STRING 

STRING TO BE PRINTED 

BACK TO ORIGINAL PSECT 

NOTE THAT THIS IS STILL LOCAL 

LABEL BLOCK THAT WAS STARTED 

BY .PSECT STRINGS 

LOAD UP STRING ADDRESS 

TYPE IT OUT 

NOT IN SAME LOCAL LABEL 

BLOCK AS REFERENCE 



THIS CREATES NEW LOCAL LABEL 

BLOCK 

BRANCH IP LOW BIT CLEAfi 

WILL NOT PRODUCE AN ERROR 

BECAUSE LOCAL LABEL BLOCK 

IS SAVED 

SAVE CURRENT PSECT NUMBER^ 

AND THE LOCAL LABEL BLOCK 

SWITCH TO NEW PSECT 

THIS ALSO CREATES NEW 

LOCAL LABEL BLOCK 
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PNTR = 



20$: 



•ASCII /SOME ASCII TEXT/ 
.RESTORE PSECT 



MOVAB 

BSBW 

RSB 



W~PNTR,R0 
PRINT IT 



SET POINTER TO STRING 

TEXT TO BE PRINTED 

BACK TO ORIGINAL PSECT 

NOTE WE ARE BACK IN LOCAL 

LABEL BLOCK STARTED BY 

OTHERJLABEL 

LOAD UP STRING ADDRESS 

TYPE IT OUT 

IS NOW IN SAME LOCAL LABEL 

BLOCK AS REFERENCE 



Notes 



1. If the stack is full when .SAVE PSECT is issued, an error 
occurs. The stack capacity is ll. 

2. The program section context includes the values of the 
current location counter and the maximum value assigned to 
the location counter in the current program section. 

3. The alternate form of .SAVE PSECT is .SAVE. 
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.SHOW 
.NOSHOW 

.SHOW AND .NOSHOW — LISTING DIRECTIVES 

.SHOW and .NOSHOW specify listing control options in the source text 
of a program. .SHOW and .NOSHOW can be used with or without an 
argument list. 

When used with an argument list, .SHOW causes certain types of lines 
to be included in the listing file and .NOSHOW causes certain types of 
lines to be excluded. .SHOW and .NOSHOW control the listing of the 
source lines that are in conditional assembly blocks (see the 
description of .IF), macros, and repeat blocks (see Chapter 6). 

When used without arguments, these directives alter the listing level 
count. The listing level count is initialized to 0. Each time .SHOW 
appears in a program, the listing level count is incremented; each 
time .NOSHOW appears in a program, the listing level count is 
decremented. 

When the listing level count is negative, the listing is suppressed 
(unless the line contains an error). Conversely, when the listing 
level count is positive, the listing is generated. When the count is 
0, the line is either listed or suppressed, depending on the value of 
the listing control symbolic arguments. 



Formats 



.SHOW 

.SHOW argument-list 

.NOSHOW 

•NOSHOW argument-list 



Parameter 

argument -list 



One or more of the optional symbolic arguments, defined in Table 
5-7. Either the long form or the short form of the arguments can 
be used. Each argument can be used alone or in combination with 
other arguments, if multiple arguments are specified, they must 
be separated by commas, tabs, or spaces. If any argument is not 
specifically included in a listing control statement, its default 
value (Show or Noshow) is assumed throughout the source program. 
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Table 5-7 
.SHOW and .NOSHOW Symbolic Arguments 



Long Form 


Short. Form 


Default 


Function 


BINARY 


MEB 


No show 


Lists macro expansions and 
repeat block expansions 
that generate binary code. 
BINARY is a subset of 
EXPANSIONS. 


CALLS 


MC 


Show 


Lists macro calls and 
repeat block specifiers. 


CONDITIONALS 


CND 


Show 


Lists unsatisfied 
conditional code 
associated with the 
conditional assembly 
directives. 


DEFINITIONS 


MD 


Show 


Lists macro and repeat 
range definitions that 
appear in an input source 
file. 


EXPANSIONS 


ME 


Noshow 


Lists macro and repeat 
range expansions. 



Example 



.MACRO XX 



X=. 



.SHOW 
•NOSHOW 



; LIST NEXT LINE. 

j DO NOT LIST REMAINDER OF MACRO 
; EXPANSION. 



X=. 



Notes 



.ENDM 

.NOSHOW EXPANSIONS 
XX 



; DO NOT LIST MACRO EXPANSIONS. 



1. The listing level count allows macros to be listed 
selectively; a macro definition can specify .NOSHOW at the 
beginning to decrement the listing count and can specify 
•SHOW at the end to restore the listing count to its original 
value. 

2. The alternate forms of .SHOW and .NOSHOW are .LIST and 
.NLIST. 
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.S1GNED___BYTE 



.SIGNEDJBYTE — SIGNED BYTE DATA DIRECTIVE 

.SIGNED_BYTE is equivalent to .BYTE, except that VAX-11 MACRO 
indicates that the data is signed in the object module. The linker 
uses this information to test for overflow conditions. 

Format 

.SIGNED_BYTE expression-list 

Parameters 

expression-list 

An expression or list of expressions separated by commas. Each 
expression optionally can be followed by a repetition factor 
delimited by square brackets. 

An expression followed by a repetition factor has the format: 
expressionl [expression2] 
expressionl 

An expression that specifies the value to be stored. 
[expression2] 

An expression that specifies the number of times the value will 
be repeated. The expression must not contain any undefined 
symbols and must be an absolute expression (see Section 3.5). 
The square brackets are required. 



Example 



.SIGNED BYTE LABEL1-LABEL2 
.SIGNED BYTE ALPHA [20] 



DATA MUST FIT 
IN BYTE 



Note 



Specifying .SIGNED_BYTE allows the linker to detect overflow 
conditions when the value of the expression is in the range of 
128 through 255.. Values in this range can be stored as unsigned 
data but cannot be stored as signed data in a byte. 
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.SIGNED—WORD 

.SIGNEDJTORD -- SIGNED WORD STORAGE DIRECTIVE 

•SIGNED_WORD is equivalent to .WORD except that the assembler 
indicates that the data is signed in the object module. The linker 
uses this information to test for overflow conditions. .SIGNED_WORD 
is useful after the case instruction to ensure that the displacement 
fits in a word. 

Format 

.SIGNED_WORD expression-list 

Parameters 

expression-list 

An expression or list of expressions separated by commas. Each 
expression optionally can be followed by a repetition factor 
delimited by square brackets. 

An expression followed by a repetition factor has the format: 
expressionl [expression2] 
expressionl 

An expression that specifies the value to be stored. 

[expression2] 

An expression that specifies the number of times the value will 
be repeated. The expression must not contain any undefined 
symbols and must be an absolute expression (see Section 3.5). 
The square brackets are required. 

Example 

•MACRO CASE, SRC, DISPLIST,TYPE=W,LIMIT=#0,NMODE=S"#,?BASE,?MAX 

; MACBO TO USE CASE INSTRUCTION 
; SRC IS SELECTOR, 0ISPLIST IS LIST 
f Of DISPLACEMENTS, TYPE IS B-BYTB 
? W-WOR0, L-LONG, LIMIT IS THE BASE 
; VALUE OF SELECTOR 

CASE ' TYPE SRC, LfMJT,NMODE ' «MAX- s BASE>/2>-i 

; CASE INSTRUCTION 
BASEs } LOCAL LABEL SPECIFYING BASE 

, IRP EP,<DjSPLIST> ; TO SET UP OFFSET LIST 

•SIGNED WORD EP-BASE ; OFFSET LIST 

. ENDR ~ ; 

MAX. ; LOCAL LABEL USED TO COUNT AR6S 

• ENDM CASE ; 

<ERR PROC,SORT,REV SORT> ? IF XW?.R«O f BHRDR? 
IVAE,#Q f S~#<<3Q00l$*3e#OOST/2>I 

I iiOCM, LABEL SPECIFYING MSE 
ERR PROC-30G6fi$ ; OFFSET LIST 
S0«f*39000$ ; OFFSET LIST 

REV SORT-3O0QQ? ? OFFSET LIST 

i LOCAL LABEL USED TO COUNT ARCS 

? •*!, fOWARD SORT; ~2, BACKWARD SORT 



CASE 

CASEW 


IVAR 

IVAE 


30000$s 

•SIGNED 
.SIGNED" 
• SIGNED" 

30001$s 


WORD 
"WORD 
"WORD 
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CASE TEST <TEST1,TEST2,TEST3>,L,#1 ; 

CASEL TEST,#l,S~#«30003$-30002$>/2>-l 
30002: ; LOCAL LABEL SPECIFYING BASE 

OFFSET LIST 



.SIGNED WORD 
•SIGNED WORD 
.SIGNED WORD 



30003$! 



TESTl-30002$ 
TEST2-30002$ 
TEST3-30002$ 



OFFSET LIST 

OFFSET LIST 
LOCAL LABEL USED TO COUNT ARGS 
VALUE OF TEST CAN BE 1,2, OR 3 



In this example, the CASE macro uses .SIGNED WORD to create a CASEB, 
CASEW, or CASEL instruction. See Chapter 1> for a description of the 
directives used to define the macro. 



Note 



Specifying .SIGNED_WORD allows the linker to detect overflow 
conditions when the value of the expression is in the range of 
32768 through 65535. Values in this range can be stored as 
unsigned data but cannot be stored as signed data in a word. 
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.SUBTITLE 

. SUBTITLE — SUBTITLE DIRECTIVE 

.SUBTITLE causes the assembler to print a line of text in the table of 
contents that is produced immediately before the assembly listing. 
The assembler also prints the line of text as the subtitle on the 
second line of each assembly listing page. This subtitle text is 
printed on each page until altered by a subsequent .SUBTITLE directive 
in the program. 

Format 

•SUBTITLE comment-string 

Parameter 

comment -str ing 

An ASCII string from 1 to 47 characters long; excess characters 

are truncated. This string represents the line of text to be 

printed in the table of contents and as the subtitle in the 
assembly listing. 

Examples 

1. .SUBTITLE CONDITIONAL ASSEMBLY 

This directive cause the assembler to print the following 
text as the subtitle of the assembly listing: 

CONDITIONAL ASSEMBLY 

2. TABLE OF CONTENTS 

(1) 5000 ASSEMBLER DIRECTIVES 

(2) 1300 MACRO DEFINITIONS 

(2) 2300 DATA TABLES AND INITIALIZATION 

(3) 4800 MAIN ROUTINE 

(4) 2800 CALCULATIONS 

(4) 5000 I/O ROUTINES 

(5) 1300 CONDITIONAL ASSEMBLY 

During assembly, a table of contents is printed for the assembly 
listing. It contains the source page number and the line sequence 
number of the source file and the text accompanying each .SUBTITLE 
directive. 

Note 

The alternate form of .SUBTITLE is .SBTTL. 
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.TITLE 

.TITLE —r TITLE DIRECTIVE 

.TITLE assigns a name to the object module. This name is the first 15 
or fewer nonblank characters following the directive. 

Format 

.TITLE module-name comment-string 
Parameters 
module -name 

An identifier from 1 to 15 characters long. 

comment-str ing 

An ASCII string from 1 to 47 characters long; excess characters 
are truncated. 



Example 



.TITLE EVAL 



EVALUATES EXPRESSIONS 



Notes 



1. The module name specified with .TITLE bears no relationship 
to the file specification of the object module, as specified 
in the VAX-11 MACRO command line. Rather, the object module 
name appears in the linker load map, and is also the module 
name that the debugger and librarian recognize. 

2. If .TITLE is not specified, MACRO assigns the default name 
.MAIN. to the object module. If more than one .TITLE 
directive, is specified in the source program, the last .TITLE 
directive encountered establishes the name for the entire 
object module. 

3. When evaluating the module-name, MACRO ignores all spaces 
and/or tabs up to the first nonspace/nontab character after 

. TITLE « 
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.TRANSFER 



.TRANSFER — TRANSFER DIRECTIVE 



•TRANSFER redefines a global symbol for use in a shareable image. The 
linker redefines the symbol as the value of the location counter at 
the .TRANSFER directive after a shareable image is linked. 

When shareable images are relinked, they should be relinked so that 
the programs linked with them need not be relinked. This can only be 
achieved if the entry points in the shareable image do not change 
their addresses when the source code is changed and the image is 
relinked. To build such a shareable image, the programmer creates an 
object module that contains a transfer vector for each entry point and 
does not change the order of the transfer vectors. This object module 
is linked at the beginning of the shareable image and the addresses 
will remain fixed even if source code for a routine is changed. After 
each .TRANSFER directive, a register save mask (for procedures only) 
and a branch to the first instruction of the routine should appear. 

Figure 5-1 illustrates the use of entry vectors. The .TRANSFER 
directive does not cause any memory to be allocated and does not 
generate any binary code. It merely generates instructions to the 
linker to redefine the symbol when a shareable image is being created. 

•TRANSFER can be used with procedures entered by the CALLS or CALLG 
instruction. In this case, .TRANSFER is used with the .ENTRY and 
.MASK directives. The branch to the actual routine must be a branch 
to the entry point plus 2. Adding 2 to the address is necessary to 
bypass the 2-byte register save mask. 



Program 

Calling 

Procedure 



Transfer 
Vector 
Module 



Shareable < 
Image 



Other 
Object 

Modules 



Linked with Shareable Image 



Linked with Object Modules 



CALLS 



ROUTB- 



TRANSFER ROUTA 



ROUTA 
ROUTA+2 



.MASK 

BRW 

.TRANSFER ROUTB-*- 

.MASK RQUTB 

BRW ROUTB+2 - 



Program 
Calling 

Procedure 



CALLS 



ROUTB- 



. ENTRY ROUTB,0 

; START OF ROUTINE-" 

RET 



Object 

Modules 



.ENTRY ROUTB.O-*- 
; START OF ROUTINE 


RET 





Figure 5-1 Using Transfer Vectors 
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Format 

.TRANSFER symbol 
Parameter 
symbol 

A global symbol that is an entry point in a procedure or routine. 
Example 



.TRANSFER ROUTINE A 

.MASK ROUTINE A,~M<R4,R5> 



BRW 



ROUTINE A+2 



COPY ENTRY MASK 
AND ADD REGISTERS 
4 AND 5 

BRANCH TO ROUTINE 
(PAST ENTRY MASK) 



.ENTRY ROUTINE A,~M<R2,R3> ; ENTRY POINT, SAVE 

; REGISTERS 2 AND 3 



RET 

In this example, .MASK copies a routine's entry mask to the new entry 
address specified by .TRANSFER. If the routine is placed in a 
shareable image and then called, registers 2, 3, 4, and 5 will be 
saved. 
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.WARN 

.WARN — WARNING DIRECTIVE 

.WARN causes the assembler to display a warning message on the 
terminal or batch log file and in the listing file (if there is one). 

Format 

.WARN [expression] ;comment 

Parameters 

expression 

An expression whose value is displayed when .WARN is encountered 
during assembly. 

; comment 

A comment that is displayed when .WARN is encountered. The 
comment must be preceded by a semicolon. 

Example 

.IF DEFINED FULL 

•IF DEFINED DOUBLE_PREC 

.WARN ; THIS COMBINATION NOT TESTED 

• ENDC 

.ENDC 

If the symbols FULL and DOUBLE_PREC are both defined, the following 
warning message is displayed. 

%MACRO-W-GENWRN, Generated WARNING: THIS COMBINATION NOT TESTED 

Notes 

1. .WARN, .ERROR, and .PRINT are called the message display 
directives. They can be used to display information 
indicating that a macro call contains an error or an illegal 
set of conditions (see Chapter 6 for more information on 
macro calls) . 

2. When the assembly is finished, the assembler displays the 
total . number of errors and warnings and the page numbers and 
line numbers of the lines causing the errors or warning on 
the terminal (or in the batch log file) . See the VAX- 11 
MACRO User's Guide for more information on errors and 
warnings. 

3. If .WARN is included in a macro library (see the VAX- 11 MACRO 
User's Guide ) , the comment should end with an additional 
semicolon. Otherwise, the comment will be stripped from the 
directive and will not be displayed when the macro is called. 

4. The line containing the .WARN directive is not included in 
the listing file. 

5. If the expression has a value of 0, it is not displayed in 
the warning message. 
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.WEAK 

.WEAK — WEAK SYMBOL ATTRIBOTE DIRECTIVE 

.WEAK specifies symbols that are either defined externally in another 
module or defined globally in the current module. .WEAK suppresses 
any object library search for the symbol. 

When .WEAK specifies a symbol that is not defined in the current 
module, the symbol is externally defined. If the linker finds the 
symbol's definition in another module, it uses that definition. If 
the linker does not find an external definition, the symbol has a 
value of and the linker does not report an error. The linker does 
not search a library for the symbol, but if a module brought in from a 
library for another reason contains the symbol definition, the linker 
uses it. 

When .WEAK specifies a symbol that is defined in the current module, 
the symbol is considered to be globally defined. However, if this 
module is inserted in an object library, this symbol is not inserted 
in the library's symbol table. Consequently, searching the library at 
link time to resolve this symbol does not cause the module to be 
included. 

Format 

.WEAK symbol -list 
Parameter 
symbol -list 

A list of legal symbols separated by commas. 
Example 

.WEAK I0CAR,LAB 3 
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.WORD 

.WORD — WORD STORAGE DIRECTIVE 

.WORD generates successive words (2 bytes) of data in the object 
module. 

Format 

.WORD expression-list 

Parameter 

expression-list 

One or more expressions separated by commas. Each expression 
optionally can be followed by a repetition factor delimited by 
square brackets. 

An expression followed by a repetition factor has the format: 
expressionl [expression2] 
expressionl 

An expression that specifies the value to be stored. 
[expression2] 

An expression that specifies the number of times the value will 
be repeated. The expression must not contain any undefined 
symbols and must be an absolute expression (see Section 3.5). 
The square brackets are required. 

Example 

.WORD ~X3F,FIVE[3] ,32 



Notes 



1. The expression is first evaluated as a longword, then 
truncated to a word. The value of the expression should be 
in the range of -32768 through 32767 for signed data or 
through 65535 for unsigned data. The assembler displays an 
error if the high-order 2 bytes of the longword expression 
have a value other than or "XFFFF. 

2. The .SIGNED WORD directive is the same as .WORD except that 
the assembler displays a diagnostic message if a value is in 
the range from 32768 to 65535. 
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CHAPTER 6 
MACROS 



By using macros, a programmer can use a single line to insert a 
sequence of source lines into a program. 

A macro definition contains the source lines of the macro. The macro 
definition can optionally have formal arguments. These formal 
arguments can be used throughout the sequence of source lines. Later, 
the formal arguments are replaced by the actual arguments in the macro 
call. 

The macro call consists of the macro name optionally followed by 
actual arguments. The assembler replaces the line containing the 
macro call with the source lines in the macro definition. It replaces 
any occurrences of formal arguments in the macro definition with the 
actual arguments specified in the macro call. This process is called 
the macro expansion. 

By default, macro expansions are not printed in the assembly listing. 
They are printed only when the .SHOW directive (see description in 
Chapter 5) specifies the EXPANSIONS argument. In the examples in this 
chapter, the macro expansions are listed as they would appear if .SHOW 
EXPANSIONS was specified in the source file. 

The macro directives provide facilities for performing eight 
categories of functions. Table 6-1 lists these categories and the 
directives that fall under them. Section 6.1 describes macro 
arguments. Section 6.2 describes the directives in detail. For ease 
of reference, the directives are presented in alphabetical order. 



6.1 ARGUMENTS IN MACROS 

Macros have two types of arguments: actual and formal. Actual 
arguments are the strings given in the macro call after the name of 
the macro. Formal arguments are specified by name in the macro 
definition: that is, after the macro name in the .MACRO directive. 
Actual arguments in macro calls and formal arguments in macro 
definitions can be separated by commas, tabs, or spaces. 

The number of actual arguments in the macro call can be less than or 
equal to the number of formal arguments in the macro definition. But 
if the number of actual arguments is greater than the number of formal 
arguments, the assembler displays an error message. 

Formal and actual arguments normally maintain a strict positional 
relationship. That is, the first actual argument in a macro call 
replaces all occurrences of the first formal argument in the macro 
definition. However, this strict positional relationship can be 
overridden by the use of keyword arguments (see Section 6.1.2). 
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Table 6-1 
Summary of Macro Directives 



Category 


Directives* 


Macro Definition 
Directives 


. MACRO 

• ENDM 


Macro Library 
Directives 


.LIBRARY 
.MCALL 


Macro Deletion 
Directive 


.MDELETE 


Macro Exit 
Directive 


.MEXIT 


Argument Attribute 
Directives 


.NARG 
.NCHR 
.NTYPE 


Indefinite Repeat 
Block Directives 


.IRP 
.IRPC 


Repeat Block 
Directives 


.REPEAT (.REPT) 


End Range 
Directive 


.ENDR 



* The alternate form, if any, is 
given in parentheses. 



An example of a macro definition using formal arguments follows: 

ARG1,ARG2,ARG3 



.MACRO STORE 

.LONG ARG1 

.WORD ARG3 

.BYTE ARG2 

.ENDM STORE 



ARG1 IS FIRST ARGUMENT 
ARG3 IS THIRD ARGUMENT 
ARG2 IS SECOND ARGUMENT 



The following two examples show possible calls and expansions of the 
macro defined above. 



1. 



2. 



STORE 
.LONG 
• WORD 
.BYTE 

STORE 
.LONG 
.WORD 
.BYTE 



3,2,1 
3 

1 
2 

X,X-Y,Z 

X 

Z 

X-Y 



MACRO CALL 

3 IS FIRST ARGUMENT 

1 IS THIRD ARGUMENT 

2 IS SECOND ARGUMENT 

MACRO CALL 
X IS FIRST ARGUMENT 
Z IS THIRD ARGUMENT 
X-Y IS SECOND ARGUMENT 
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6.1.1 Default Values 

Default values are values that are defined in the macro definition. 
They are used when no value is specified in the macro call for a 
formal argument. 

Default values are specified in the .MACRO directive as follows: 

formal-argument-name = default-value 

An example of a macro definition specifying default values follows: 

.MACRO STORE ARG1=12 ,ARG2=0,ARG3=1000 

.LONG ARG1 

.WORD ARG3 

.BYTE ARG2 

•ENDM STORE 

The following three examples show possible calls and expansions of the 
macro defined above. 

1. STORE ; NO ARGUMENTS SUPPLIED 



2. STORE ,5,X ; LAST TWO ARGUMENTS SUPPLIED 



.LONG 
• WORD 
.BYTE 


12 

1000 




STORE 
.LONG 
.WORD 
.BYTE 


,5,X 
12 
X 
5 


STORE 
.LONG 
• WORD 
.BYTE 


1 
1 

1000 




3. STORE 1 ; FIRST ARGUMENT SUPPLIED 



6.1.2 Keyword Arguments 

Keyword arguments allow a macro call to specify the arguments in any 
order; however, the macro call must specify the same formal argument 
names that appear in the macro definition. Keyword arguments are 
useful when a macro definition has many formal arguments, only some of 
which need to he specified in the call. 

In any one macro call the arguments should be either all positional 
arguments or all keyword arguments. When positional and keyword 
arguments are combined in a macro, only the positional arguments 
correspond by position to the formal arguments; the keyword arguments 
are not used. If a formal argument corresponds to both a positional 
argument and a keyword argument, the argument that appears last in the 
macro call overrides any other argument definition for the same 
argument. 

For example, the following macro definition specifies three arguments: 

.MACRO STORE ARG1 ,ARG2,ARG3 

. LONG ARG1 

.WORD ARG3 

•BYTE ARG2 

.ENDM STORE 
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The following macro call specifies keyword arguments: 

STORE ARG3=27+5/4,ARG2=5,ARGl=SYMBL 

. LONG SYMBL 

.WORD 27+5/4 

.BYTE 5 

Because the keywords are specified in the macro call, the arguments in 
the macro call need not be given in the order they were listed in the 
macro definition. 



6.1.3 String Arguments 

If an actual argument is a string containing characters that the 
assembler interprets as separators (such as a tab, space, or comma), 
the string must be enclosed by delimiters. String delimiters are 
usually paired angle brackets (<>) . However, the assembler also 
interprets any character after an initial circumflex (~) as a 
delimiter. Thus, to pass an angle bracket as part of a string, the 
programmer can use the circumflex form of the delimiter. 

The following are examples of delimited macro arguments: 

<HAVE THE SUPPLIES RUN OUT?> 

<LAST NAME, FIRST NAME> 

<LAB: CLRL R4> 

"%ARGUMENT IS <LAST,FIRST> FOR CALL% 

~?EXPRESSION IS <5+3>*<4+2>? 

In the last two examples the initial circumflex indicates the percent 
sign (%) and question mark (?) , respectively, are the delimiters. 
Note that only the left hand delimiter is preceded by a circumflex. 

The assembler interprets a string argument enclosed by delimiters as 
one actual argument and associates it with one formal argument. If a 
string argument that contains separator characters is not enclosed by 
delimiters, the assembler interprets it as successive actual arguments 
and associates it with successive formal arguments. 

For example, the following macro call has one formal argument. 

.MACRO REPEAT STRNG 

.ASCII /STRNG/ 

.ASCII /STRNG/ 

.ENDM REPEAT 

The following two macro calls demonstrate actual arguments with and 
without delimiters. 

1. REPEAT <A B C D E> 
.ASCII /A B C D E/ 
.ASCII /A B C D E/ 

2. REPEAT A B C D E 

%MACRO-E-TOOMNYARGS, Too many arguments in MACRO call 

Note that the assember interpreted the second macro call as having 
five actual arguments instead of one actual argument with spaces. 

When a macro is called, the assembler removes the delimiters (if 
present) around a string before associating it with the formal 
arguments. 
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If a string contains a semicolon, the string must be enclosed by 
delimiters, or the semicolon will mark the start of the comment field. 

To pass a number containing a radix or unary operator (for example, 
*XF19) , the entire argument must be enclosed by delimiters, or the 
assembler will interpret the radix operator as a delimiter. The 
following- are macro arguments that are enclosed in delimiters because 
they contain radix operators: 

<~XF19> 

<*B01100011> 

<~F1.5> 

Macros can be nested, that is a macro definition can contain a call to 
another macro. If within a macro definition, another macro is called 
and passed a string argument, the programmer must delimit the argument 
so that the entire string is passed to the second macro as one 
argument. 



The following macro definition contains a call 
defined in an earlier example: 



to the REPEAT macro 



LABI: 



.MACRO CNTRPT LAB1,LAB2,STR ARG 



.BYTE 



LAB2-LAB1-1 



LENGTH OF 2+STRING 



LAB 2: 



REPEAT <STR_ARG> 
. ENDM CNTRPT 



; CALL REPEAT MACRO 



Note that the argument in the call to REPEAT is enclosed in angle 
brackets even though the actual argument does not contain any 
separator characters. This is done because the actual argument in the 
call to REPEAT is a formal argument in the macro definition and will 
be replaced with an actual argument that may contain separator 
characters. 



The following example calls the macro CNTRPT which in turn 
macro REPEAT: 



calls the 



ST: 



FIN: 



CNTRPT ST,FIN,<LEARN YOUR ABC'S> 

.BYTE FIN-ST-1 ; 

REPEAT < LEARN YOUR ABC'S> ; 

.ASCII /LEARN YOUR ABC'S/ 

.ASCII /LEARN YOUR ABC'S/ 



LENGTH OF 2*STRING 
CALL REPEAT MACRO 



An alternative method to pass string arguments in nested macros is to 
enclose the macro argument in nested delimiters. In this case the 
macro calls in the macro definitions should not have delimiters. Each 
time the delimited argument is used in a macro call, the assembler 
removes the outermost pair of delimiters before associating it with 
the formal argument. This method is not recommended because it 
requires that the programmer know how deeply a macro is nested. 



The following macro definition also contains 
macro: 



call to the repeat 



.MACRO CNTRPT2 LABI, LAB2,STR_ARG 
LABI: .BYTE LAB2-LAB1-1 ; LENGTH OF 2*STRING 



REPEAT STR ARG 



; CALL REPEAT MACRO 



LAB 2: 



.ENDM CNTRPT2 
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Note that the argument in the call to REPEAT is not enclosed in angle 
brackets. 

The following example calls the macro CNTRPT2: 

CNTRPT2 BEG, TERM, «MIND YOUR P'S AND Q* S>> 
BEG: .BYTE TERM-BEG-1 ; LENGTH OF 2*STRING 

REPEAT <MIND YOUR P'S AND Q'S> 

.ASCII /MIND YOUR P'S AND Q*S/ 

•ASCII /MIND YOUR P'S AND Q'S/ 
TERM: 

Note that even though the call to REPEAT in the macro definition is 
not enclosed in delimiters, the call in the expansion is enclosed in 
delimiters because the call to CNTRPT2 contains nested delimiters 
around the string argument. 



6.1.4 Argument Concatenation 

The argument concatenation operator, the apostrophe ('), concatenates 
a macro argument with some constant text. Apostrophes can either 
precede or follow a formal argument name in the macro source. 

If an apostrophe precedes the argument name, the text before the 
apostrophe is concatenated with the actual argument when the macro is 
expanded. For example, if ARG1 is a formal argument associated with 
the actual argument TEST, ABCDE'ARGl is expanded to ABCDETEST. 

If an apostrophe follows the formal argument name, the actual argument 
is concatenated with the text that follows the apostrophe when the 
macro is expanded. For example, if ARG2 is a formal argument 
associated with the actual argument MOV, ARG2'L is expanded to MOVL. 

Note that the apostrophe itself does not appear in the macro 
expansion. 

To concatenate two arguments, separate the two formal arguments with 
two successive apostrophes. Two apostrophes are needed because each 
concatenation operation discards an apostrophe from the expansion. 

An example of a macro definition that uses concatenation follows: 

.MACRO CONCAT INST, SIZE ,NUM 
TEST'NUM': INST''SIZE R0,R'NUM 
TEST'NUM'X: 

. ENDM CONCAT 

Note that two successive apostrophes are used when concatenating the 
two formal arguments INST and SIZE. 

An example of a macro call and expansion follows: 

CONCAT M0V,L,5 
TEST5: MOVL R0,R5 
TEST5X: 
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6.1.5 Passing Numeric Values of Symbols 

When a symbol is specified as an actual argument, the name of the 
symbol, not the numeric value of the symbol, is passed to the macro. 
However, the value of the symbol can be passed by inserting a 
backslash before the symbol in the macro call. The assembler then 
passes the characters representing the decimal value of the symbol to 
the macro. For example, if the symbol COUNT has a value of 2 and the 
actual argument specified is \COUNT, the assembler passes the string 
"2" to the macro; it does not pass the name of the symbol, "COUNT". 

Passing numeric values of symbols is especially useful with the 
apostrophe (') concatenation operator for creating new symbols. 

An example of a macro definition for passing numeric values of symbols 
follows: 

.MACRO TESTDEF, TESTNO,ENTRYMASK=~?~M<>? 

.ENTRY TEST'TESTNO,ENTRYMASK ; USES ARG CONCATENATION 

•ENDM TESTDEF 

The following example shows a possible call and expansion of the macro 
defined above: 

COUNT = 2 

TESTDEF \COUNT 

•ENTRY TEST2,~M<> 
COUNT = COUNT + 1 

TESTDEF \COUNT,~?*M<R3,R4>? 

.ENTRY TEST3,~M<R3,R4> 



6.1.6 Created Local Labels 

Local labels are often very useful in macros. Although the programmer 
can specify local labels in the macro definition, these local labels 
might be duplicated elsewhere in the local label block and might thus 
cause errors. However, the programmer can use the assembler to create 
local labels in the macro expansion which will not conflict with other 
local labels. These labels are called created local labels. 

Created local labels range from 30000$ through 65535$. Each time the 
assembler creates a new local label, it increments the numeric part of 
the label name by 1. Consequently, no user-defined local labels 
should be in the range of 30000$ through 65535$. 

The programmer specifies a created local label by a question mark (?) 
placed in front of the formal argument name. When the macro is 
expanded, the assembler creates a new local label if the corresponding 
actual argument is blank. If the corresponding actual argument is 
specified, the assembler substitutes the actual argument for the 
formal argument. Created local symbols can be used only in the first 
31 formal arguments specified in the .MACRO directive. 

Created local labels can be associated only with positional actual 
arguments; created local labels cannot be associated with keyword 
actual arguments. 
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The following example is a macro definition specifying a created local 
label: 

.MACRO POSITIVE ARG1,?L1 

TSTL ARG1 

BGEQ LI 

MNEGL ARG1,ARG1 

LI: .ENDM POSITIVE 

The following three calls and expansions of the macro defined above 
show both created local labels and a user-specified local label: 

1. POSITIVE RO 
TSTL RO 

BGEQ 30000$ 
MNEGL R0,R0 
30000$: 

2. POSITIVE COUNT 
TSTL COUNT 

BGEQ 30001$ 
MNEGL COUNT, COUNT 
30001$: 

3. POSITIVE VALUE ,10$ 
TSTL VALUE 

BGEQ 10$ 
MNEGL VALUE, VALUE 
10$: 



6.1.7 Macro String Operators 

The three macro string operators are: 

• % LENGTH 

• % LOCATE 

• % EXTRACT 

These operators perform string manipulations on macro arguments and 
ASCII strings. They can be used only in macros and repeat blocks. 
The following sections describe these operators and give their formats 
and examples of their use. 
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%LENGTH 



6.1.7.1 %LENGTH Operator - The %LENGTH operator returns the length of 
a string. For example, the value of %LENGTH(<ABCDE>) is 5. 

Format 

%LENGTH(string) 

Parameters 

string 

A macro argument or a delimited string. The string can be 
delimited by angle brackets or a character preceded by a 
circumflex (see Section 6.1.3). 

Examples 

Macro definition: 



.MACRO CHK_SIZE 

.IF GREATER_EQUAL 

.IF LESS_THAN 

. ERROR ; 

.ENDC 

.IF_FALSE 

. ERROR ; 

.ENDC 

.ENDM CHK SIZE 



ARG1 ; MACRO CHECKS IF ARG1 

%LENGTH(ARGl)-3 ; IS BETWEEN 3 AND 
6-%LENGTH(ARGl) ; 6 CHARACTERS LONG 
ARGUMENT ARG1 IS GREATER THAN 6 CHARACTERS 

; IF MORE THAN 6 



ARGUMENT ARG1 IS LESS 



; IF LESS THAN 3 
THAN 3 CHARACTERS 
; OTHERWISE DO 
; NOTHING 



Macro calls and expansions of the macro defined above: 

1. CHK_SIZE A ; SHOULD BE TOO SHORT 

.IF GREATER_EQUAL 1-3 ; IS BETWEEN 3 AND 

.IF LESS_THAN 6-1 ; 6 CHARACTERS LONG 
.ERROR ; ARGUMENT A IS GREATER THAN 6 CHARACTERS 
.ENDC ; IF MORE THAN 6 

.IF_FALSE ; IF LESS THAN 3 

%MACRO-E-GENERR, Generated ERROR: ARGUMENT A IS LESS THAN 3 CHARACTERS 



2. 



.ENDC 



CHK_SIZE ABC 

.IF GREATER_EQUAL 

.IF LESSJTHAN 

.ERROR 

.ENDC 

. IF_FALSE 

. ERROR 

.ENDC 



; OTHERWISE DO 

; SHOULD BE OK 
3-3 ; IS BETWEEN 3 AND 
6-3 ; 6 CHARACTERS LONG 
ARGUMENT ABC IS GREATER THAN 6 CHARACTERS 

; IF MORE THAN 6 

; IF LESS THAN 3 

ARGUMENT ABC IS LESS THAN 3 CHARACTERS 

; OTHERWISE DO 
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%LOCATE 



6.1.7.2 % LOCATE Operator - The %LOCATE operator locates a substring 
within a string. If %LOCATE finds a match of the substring, it 
returns the character position of the first character of the match in 
the string. For example, the value of % LOCATE (<D>,<ABCDEF>) is 3. 
Note that the first character position of a string is 0. If %L0CATE 
does not find a match, it returns a value equal to the length of the 
string. For example, the value of %LOCATE(<Z>,<ABCDEF>) is 6. 

The %L0CATE operator returns a numeric value that can be used in any 
expression. 

Format 

%L0CATE(stringl,string2 [, symbol] ) 

Parameters 

stringl 

A string that specifies the substring. The substring can be 
either a macro argument or a delimited string. The delimiters 
can be either angle brackets or a character preceded by a 
circumflex. 

string2 

The string that is searched for the substring. The string can be 
either a macro argument or a delimited string. The delimiters 
can be either angle brackets or a character preceded by a 
circumflex. 

symbol 

An optional symbol or decimal number that specifies the position 
in string2 at which the assembler should start the search. If 
this argument is omitted, the assembler starts the search at 
position (the beginning of the string) . A symbol must be an 
absolute symbol that has been previously defined and a number 
must be an unsigned decimal number. Expressions and radix 
operators are not allowed. 

Example 

Macro definition: 

.MACRO BIT_NAME ARG1 ; CHECKS IF ARG1 IS IN LIST 

.IF EQUAL %L0CATE(ARG1,<DELDFWDLTDM0ESC>)-15 

; IF IT IS NOT PRINT ERROR 
.ERROR ; ARG1 IS AN INVALID BIT NAME 

•ENDC • IF IT IS DO 

•ENDM BIT_NAME ; NOTHING 

Macro calls and expansions of the macro defined above: 

1. BIT_NAME ESC ; IS IN LIST 

•IF EQUAL 12-15 

; IF IT IS NOT PRINT ERROR 
.ERROR ; ESC IS AN INVALID BIT NAME 



.ENDC 



IF IT IS DO 



6-10 



MACROS 

2. BIT_NAME FOO ; NOT IN LIST 

.IF EQUAL 15-15 

; IF IT IS NOT PRINT ERROR 
%MACRO-E-GENERR, Generated ERROR: FOO IS AN INVALID BIT NAME 

.ENDC ; IF IT IS DO 



Note 



If the optional symbol is specified, the search begins at the 

character position of string2 specified by the symbol. For 

example, the value of %LOCATE(<ACE>,<SPACE_HOLDER> ,5) is 12 
because there is no match after the 5th character position. 

% EXTRACT 



6.1.7.3 %EXTRACT Operator - The %EXTRACT operator extracts a 
substring from a string. It returns the substring that begins at the 
specified position and is the specified length. For example, the 
value of %EXTRACT(2,3,<ABCDEF>) is CDE. Note that the first character 
in a string is in position 0. 

Format 

%EXTRACT ( symbol 1 , symbol 2 , string ) 

Parameters 

symbol 1 

A symbol or decimal number that specifies the starting position 
of the substring. A symbol must be an absolute symbol that has 
been previously defined and a number must be an unsigned decimal 
number. Expressions and radix operators are not allowed. 

symbol 2 

A symbol or decimal number that specifies the length of the 
substring. A symbol must be an absolute symbol that has been 
previously defined and a number must be an unsigned decimal 
number. Expressions and radix operators are not allowed. 

string 

A macro argument or a delimited string. The string can be 
delimited by angle brackets or a character preceded by a 
circumflex. 

Example 

Macro definition: 

.MACRO RESERVE ARG1 
XX = % LOCATE (<=>,ARG1) 

.IF EQUAL XX-%LENGTH(ARG1) 

.WARN ; INCORRECT FORMAT FOR MACRO CALL - ARG1 

..MEXIT 

.ENDC 
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% EXTRACT (0, XX, ARG1) :: 
XX = XX+1 

.BLKB %EXTRACT(XX,3,ARG1) 

.ENDM RESERVE 

Macro calls and expansions of the macro defined above: 

1. RESERVE FOOBAR 
XX = 6 

.IF EQUAL XX-6 
%MACRO-W-GENWRN, Generated WARNING: INCORRECT FORMAT FOR MACRO CALL - FOOBA: 

.MEXIT 

2. RESERVE LOCATION=12 
XX = 8 

.IF EQUAL XX- 11 

.WARN ; INCORRECT FORMAT FOR MACRO CALL - LOCATION=12 

•MEXIT 

.ENDC 

LOCATION:: 
XX = XX+1 

.BLKB 12 



Notes 



If the starting position specified is greater than or equal to 

the length of the string, %EXTRACT returns a null string (a 

string of characters). If the length specified is 0, %EXTRACT 
returns a null string. 



6.2 MACRO DIRECTIVES 

The remainder of this chapter describes the macro directives in 
detail, showing their formats and giving examples of their use. The 
directives are presented in alphabetical order. 
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.ENDM 

.ENDM — END DEFINITION DIRECTIVE 

.ENDM terminates the macro definition. See the description of .MACRO 
for an example of the use of .ENDM. 

Format 

.ENDM [macro-name] 
Parameter 
macro-name 

The name of the macro whose definition is to be terminated. The 
macro name is optional; but, if specified, it must match the 
name defined in the matching .MACRO directive. The macro name 
should be specified so that the assembler can detect any 
improperly nested macro definitions. 



Note 



If .ENDM is encountered outside a macro definition, the assembler 
displays an error message. 

.ENDR 



.ENDR — END RANGE DIRECTIVE 

.ENDR indicates the end of a repeat range. It must be the final 
statement of every indefinite repeat block directive (.IRP and .IRPC) 
and every repeat block directive (.REPEAT). See the description of 
these directives for examples of the use of .ENDR. 

Format 

.ENDR 
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.IRP — INDEFINITE REPEAT ARGUMENT DIRECTIVE 

.IRP replaces a formal argument with successive actual arguments 
specified in an argument list. This replacement process occurs during 
the expansion of the indefinite repeat block range. The .ENDR 
directive specifies the end of the range. 

.IRP is analogous to a macro definition with only one formal argument. 
At each expansion of the repeat block, this formal argument is 
replaced with successive elements from the argument list. The 
directive and its range are coded inline within the source program. 
This type of macro definition and its range do not require calling the 
macro by name, as do other macros described in this chapter. 

•IRP can appear either within or outside another macro definition, 

indefinite repeat block, or repeat block (see the description of 

.REPEAT). The rules for specifying .IRP arguments are the same as 
those for specifying macro arguments. 

Format 

IRP symbol, Orgument list> 



ange 

,ENDR 
Parameters 

symbol 

A formal argument that is successively replaced with the 

specified actual arguments enclosed in angle brackets. If no 

formal argument is specified, the assembler displays an error 
message. 

<argument list> 

A list of actual arguments enclosed in angle brackets and used in 
expanding the indefinite repeat range. An actual argument can 
consist of one or more characters; multiple arguments must be 
separated by a legal separator (comma, space, or tab). If no 
actual arguments are specified, no action is taken. 



range 



The block of source text to be repeated once for each occurrence 
of an actual argument in the list. The range can contain macro 
definitions and repeat ranges. .MEXIT is legal within the range. 
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Example 

Macro definition: 



SUBR f Al,A2,A3,A4,A5,A6,A7,A8,A9,A10 



.MACRO CALL_SUB 

.NARG COUNT 

.IRP ARG,<A10,A9,A8,A7,A6,A5,A4,A3,A2,A1> 

.IIF NOT_BLANK ARG , PUSHL ARG 

.ENDR 

CALLS #<COUNT-l>,SUBR ; NOTE SUBR IS COUNTED 

.ENDM CALL_SUB 

Macro call and expansion of the macro defi ed above: 

CALL_SUB TEST, INRES, INTES, U LIS, OUTCON, #205 

.NARG COUNT 

. IRP ARG ,<,,,, , # 205 , OUTCON , UNLIS , INTES , INRES> 



IIF NOT 
, ENDR 
, IIF NOT 



.IIF 
.IIF 
.IIF 
.IIF 
.IIF 
.IIF 
.IIF 
• IIF 
.IIF 
CALLS 



NOT 
NOT 
NOT 
NOT 
NOT* 
NOT 
NOT 
NOT 
NOT" 



BLANK ARG, 



BLANK 
"BLANK 

"blank 

'BLANK 
"BLANK 

"blank 
"blank 
"blank 
"blank 
"blank 



#205, 

OUTCON, 

UNLIS, 

INTES, 

INRES, 



PUSHL ARG 



PUSHL 
PUSHL 
PUSHL 
PUSHL 
PUSHL 
PUSHL 
PUSHL 
PUSHL 
PUSHL 
PUSHL 



?<COUNT-l>,TEST 



#205 

OUTCON 

UNLIS 

INTES 

INRES 

; NOTE 



TEST IS COUNTED 



This example uses the .NARG directive to count the arguments and the 
.IIF NOT_BLANK directive (see descriptions of .IF and .IIF in Chapter 
5). to determine whether the actual argument is blank. If the 
argument is blank, no binary code is generated. 
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.IRPC 



.IRPC — INDEFINITE REPEAT CHARACTER DIRECTIVE 

.IRPC is similar to .IRP except that .IRPC permits single-character 
substitution, rather than argument substitution. On each iteration of 
the indefinite repeat range, the formal argument is replaced with each 
successive character in the specified string. The .ENDR directive 
specifies the end of the range. 

.IRPC is analogous to a macro definition with only one formal 
argument. At each expansion of the repeat block, this formal argument 
is replaced with successive characters from the actual argument 
string. The directive and its range are coded inline within the 
source program and do not require calling the macro by name, as do 
other macros described in this chapter. 

•IRPC can appear either within or outside another macro definition, 
indefinite repeat block, or repeat block (see description of .REPEAT). 

Format 



IRPC symbol, <string> 



range 



ENDR 



Parameters 



symbol 



A formal argument that is successively replaced with the 
specified characters enclosed in angle brackets. If no formal 
argument is specified, the assembler displays an error message. 



<string> 



A sequence of characters enclosed in angle brackets and used in 
the expansion of the indefinite repeat range. Although the angle 
brackets are required only when the string contains separating 
characters, their use is recommended for legibility. 

range 

The block of source text to be repeated once for each occurrence 
of a character in the list. The range can contain macro 
definitions and repeat ranges. .MEXIT is legal within the range. 

Example 

Macro Definition: 



•MACRO HASH SYM 



.NCHR 
.IRPC 
HV = HV*A?CHR? 
• ENDR 
.ENDM 



SYMBOL 



HV,<SYMBOL> 
CHR,<SYMBOL> 



HASH SYM 
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Macro call and expansion of the macro defined above: 

HASH_SYM <MOVC5> 
.NCHR HV,<M0VC5> 
CHR,<M0VC5> 







.IRPC 


HV 


— 


HV+~A?CHR? 
.ENDR 


HV 


= 


HV+"A?M? 


HV 


= 


HV+"A?0? 


HV 


= 


HV+~A?V? 


HV 


= 


HV+~A?C? 


HV 


= 


HV+"A?5? 



This example uses the .NCHR directive to count the number of 
characters in actual argument. 
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.LIBRARY 

.LIBRARY—MACRO LIBRARY DIRECTIVE 

.LIBRARY adds a name to the VAX-11 MACRO library list that is 
searched whenever a .MCALL or an undefined opcode is encountered. The 
libraries are searched in the reverse order in which they were 
specified to the assembler. 

If the programmer omits any information from the macro-library-name 
argument, default values are assumed. The device defaults to the 
user s disk; the directory defaults to the user's directory; and the 
file type defaults to MLB. 

DIGITAL recommends that libraries be specified in the MACRO command 
line with the /LIBRARY qualifier rather than with the .LIBRARY 
directive. The .LIBRARY directive makes moving files cumbersome. 

Format 

.LIBRARY macro-library-name 

Parameter 

macro-1 ibrary-name 

A delimited string that is the file specification of a macro 
library. 



Example 



.LIBRARY /DB1:[TEST]USERM/ ; MACRO LIBRARY USERM.MLB 
.LIBRARY ?DB1:SYSDEF.MLB? 
.LIBRARY \CURRENT.MLB\ 
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.MACRO 



.MACRO — MACRO DEFINITION DIRECTIVE 



.MACRO begins the definition of a macro. It gives the macro name and 
a list of formal arguments (see Section 6.1). If the name specified 
is the same as the name of a previously defined macro, the previous 
definition is deleted and replaced with the new one. The .MACRO 
directive is followed by the source text to be included in the macro 
expansion. The .ENDM directive specifies the end of the range. 

Macro names do not conflict with user-defined symbols. A macro and a 
user-defined symbol can both have the same name. 

When the assembler encounters a .MACRO directive, it adds the macro 
name to its macro name table and stores the source text of the macro 
(up to the matching .ENDM directive). No other processing occurs 
until the macro is expanded. 

The symbols in the formal argument list are associated with the macro 
name and are limited to the scope of the definition of that macro. 
For this reason, the symbols that appear in the formal argument list 
can also appear elsewhere in the program. 

Format 

•MACRO macro-name [formal-argument-list] 



range 

.ENDM [macro name] 

Parameters 

macro-name 

The name of the macro to be defined; this name can be any legal 
symbol up to 15 characters long. 

formal-argument-list 

The symbols, separated by commas, to be replaced by the actual 
arguments in the macro call. 

range 

The source text to be included in the macro expansion. 
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Example 

Macro definition: 





.MACRO 


USERDEF 




.PSECT 


DEFS,ABS 


MYSYM= 


5 




HIVAL= 


"XFFF123 


LOWVAL= 









.PSECT 


RWDATA , NOEXE , LONG 


TABLE: 


• BLKL 


100 


LIST: 


.BLKB 


10 




.MACRO 


USERDEF 




.ENDM 


USERDEF 




.ENDM 


USERDEF 



REDEFINE IT TO NULL 



Macro calls and expansions of the macro defined above: 

1. USERDF ; SHOULD EXPAND DATA 

.PSECT DEFS,ABS 
MYSYM= 5 
HIVAL= "XFFF123 
LOWVAL= 

.PSECT RWDATA, NOEXE, LONG 
TABLE: .BLKL 100 
LIST: .BLKB 10 



2. 



.MACRO USERDEF 
.ENDM USERDEF 

USERDF 



; REDEFINE IT TO NULL 



SHOULD EXPAND NOTHING 



In this example, when the macro is called the first time it defines 
some symbols and data storage areas and then redefines itself. When 
the macro is called a second time, the macro expansion contains no 
source text. 

Notes 

1. If a macro has the same name as a VAX-11/780 opcode, the 
macro is used instead of the instruction. This feature 
allows a programmer to temporarily redefine an opcode. 

2. If a macro has the same name as a VAX-11/780 opcode and is in 
a macro library, the .MCALL directive must be used to define 
the macro. Otherwise, because the symbol is already defined 
(as the opcode) , the assembler will not search the macro 
libraries. 

3. The programmer can redefine a macro with new source text 
during assembly by specifying a second .MACRO directive with 
the same name. Including a second .MACRO directive within 
the original macro definition causes the first macro call to 
redefine the macro. This is useful when a macro performs 
initialization or defines symbols; that is, when an 
operation is performed only once. The macro redefinition can 
eliminate unneeded source text in a macro or it can delete 
the entire macro. The .MDELETE directive provides another 
way to delete macros. 
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.MCALL 



.MCALL--MACRO CALL DIRECTIVE 



.MCALL specifies the names of the system and/or user-defined macros 
that are required to assemble the source program but are not defined 
in the source file. 

If any named macro is not found upon completion of the search (that 
is, if the macro is not defined in any of the macro libraries), the 
assembler displays an error message. 

Format 

.MCALL macro-name-list 
Parameter 

macro-name-list 

A list of macros to be defined for this assembly. The names must 
be separated by commas. 



Example 

.MCALL INSQUE 



SUBSTITUTE MACRO IN 
LIBRARY FOR INSQUE 
INSTRUCTION 



Note 



.MCALL is provided for compatibility with MACRO-11; DIGITAL 
recommends that it not be used. When VAX-11 MACRO finds an 
unknown symbol in the opcode field, it automatically searches all 
macro libraries. If it finds the symbol in a library, it uses 
the macro definition and expands the macro reference. If VAX-11 
MACRO does not find the unknown symbol in the library, it 
displays an error message. There is one exception for which 
.MCALL must be used: when a macro has the same name as an opcode 
(see description of .MACRO) . 
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.MDELETE 

.MDELETE — MACRO DELETION DIRECTIVE 

.MDELETE deletes the definitions of specified macros. The number of 
macros actually deleted is printed in the assembly listing on the same 
line as the .MDELETE directive. 

.MDELETE completely deletes the macro, freeing memory as necessary, 
whereas the technique of macro redefinition explained in the 
description of .MACRO merely redefines the macro. 

Format 

.MDELETE macro-name-list 

Parameter 

macro-name-list 

A list of macros whose definitions are to be deleted. The names 
must be separated by commas. 

Example 

.MDELETE USERDEF, $SSDEP,ALTR 
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.MEXIT 



.MEXIT — MACRO EXIT DIRECTIVE 



.MEXIT terminates a macro expansion before the end of the macro. 
Termination is the same as if .ENDM was encountered. The directive 
can also be used within repeat blocks. .MEXIT is most useful in 
conditional expansion of macros because it bypasses the complexities 
of nested conditional directives and alternate assembly paths. 

Format 



•MEXIT 
Example 

.MACRO ALTR 



N,A,B 



.IF EQ N 



; START CONDITIONAL ASSEMBLY BLOCK. 



■MEXIT 
.ENDC 



TERMINATE MACRO EXPANSION. 

END CONDITIONAL ASSEMBLY BLOCK. 



. ENDM ALTR 



; NORMAL END OF MACRO. 



In this example, if the actual argument for the formal argument N 
equals 0, the conditional block would be assembled, and the macro 
expansion would be terminated by .MEXIT. 



Notes 



1. 



When .MEXIT occurs in a repeat block, the assembler 
terminates the current repetition of the range and suppresses 
further expansion of the repeat range. 

When macros or repeat blocks are nested, .MEXIT exits to the 
next higher level of expansion. 



3. 



If .MEXIT occurs outside a macro definition or 
block, the assembler displays an error message. 



a repeat 
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.NARG 

.NARG — NUMBER OP ARGUMENTS DIRECTIVE 

.NARG determines the number of arguments in the current macro call. 

.NARG counts all the positional arguments specified in the macro call, 
including null arguments (specified by adjacent commas). The value 
assigned to the specified symbol does not include either any keyword 
arguments or any formal arguments that have default values. 



Format 

.NARG 
Parameter 
symbol 



symbol 



value equal to the number of 



A symbol that is assigned a 
arguments in the macro call. 

Example 

Macro definition: 

.MACRO CNT_ARG Al ,A2,A3 ,A4,A5 ,A6 ,A7 ,A8,A9=DEF9 ,A10=DEF10 

.NARG COUNTER ; COUNTER IS SET TO NO. OF ARGS 

.WORD COUNTER ; STORE VALUE OF COUNTER 

. ENDM CNT_ARG 

Macro calls and expansions of the macro defined above: 

1. 



2. 



CNT_ARG TEST, FIND, ANS 
.NARG COUNTER 
.WORD COUNTER 

CNT_ARG 

.NARG COUNTER 

.WORD COUNTER 

CNT_ARG TEST,A2=SYMB2,A3=SY3 
.NARG COUNTER 
.WORD COUNTER 



CNT_ARG ,SYMBL,, 
.NARG COUNTER 
.WORD COUNTER 



COUNTER WILL = 3 

COUNTER IS SET TO NO. OF ARGS 

STORE VALUE OF COUNTER 

COUNTER WILL = 

COUNTER IS SET TO NO. OF ARGS 

STORE VALUE OF COUNTER 

COUNTER WILL = 1 

COUNTER IS SET TO NO. OF ARGS 

STORE VALUE OF COUNTER 

KEYWORD ARGUMENTS ARE NOT COUNTED 

COUNTER WILL = 3 

COUNTER IS SET TO NO. OF ARGS 

STORE VALUE OF COUNTER 

NULL ARGUMENTS ARE COUNTED 



Note 



If .NARG appears outside of a macro, the assembler displays 
an error message. 
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.NCHR 



.NCHR-- -NUMBER OF CHARACTERS DIRECTIVE 



•NCHR determines the number of characters in a specified character 
string. It can appear anywhere in a VAX-11 MACRO program and is 
useful in calculating the length of macro arguments. 

Format 



.NCHR 
Parameters 



symbol ,<string> 



symbol 



A symbol that is assigned a value equal to 
characters in the specified character string. 



the number of 



<string> 

A sequence of printable characters. The character string must be 
delimited by angle brackets or a character preceded by a 
circumflex only if the specified character string contains a 
legal separator (comma, space, and/or tab) or a semicolon. 

Example 

Macro definition: 



.MACRO CHAR MESS 

•NCHR CHRCNT,<MESS> 

.WORD CHRCNT 

.ASCII /MESS/ 

. EN DM CHAR 



DEFINE MACRO 

ASSIGN VALUE TO CHRCNT 

STORE VALUE 

STORE CHARACTERS 

FINISH 



Macro calls and expansions of the macro defined above: 



CHAR 


<HELLO> 


.NCHR 


CHRCNT, <HELLO> 


.WORD 


CHRCNT 


.ASCII 


/HELLO/ 


CHAR 


<14, 75.39 4> 


• NCHR 


CHRCNT, <14, 75.39 


.WORD 


CHRCNT 


.ASCII 


/14, 75.39 4/ 



4> 



CHRCNT WILL = 5 
ASSIGN VALUE TO CHRCNT 
STORE VALUE 
STORE CHARACTERS 

CHRCNT WILL = 12 (DEC) 
ASSIGN VALUE TO CHRCNT 
STORE VALUE 
STORE CHARACTERS 
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NTYPE 



.NTYPE — OPERAND TYPE DIRECTIVE 

•NTYPE determines the addressing mode of the specified operand. 

The value of the symbol is set to the specified addressing mode. In 
most cases, an 8-bit (1-byte) value is returned. Bits through 3 are 
the register associated with the mode, and bits 4 through 7 are the 
addressing mode. To provide concise addressing information, the mode 
bits 4 through 7 are not exactly the same as the numeric value of the 
addressing mode described in Table 4-1. Specifically, literal mode is 
indicated by a in bits 4 through 7 instead of the values through 3 
described in Table 4-1. Mode 1 indicates an immediate mode operand, 
mode 2 indicates an absolute mode operand, and mode 3 indicates a 
general mode operand. 

For indexed addressing mode, a 16-bit (2-byte) value is returned. The 
high-order byte contains the addressing mode of the base operand 
specifier and the low-order byte contains the addressing mode of the 
primary operand (the index register) . 

See the VAX-11/780 Architecture Handbook or Chapter 4 of this manual 
for more information on addressing modes. 

Format 

.NTYPE symbol, operand 

Parameter 

symbol 

Any legal VAX-11 MACRO symbol. This symbol is assigned a value 
equal to the 8- or 16-bit addressing mode of the operand argument 
that follows. 

operand 

Any legal address expression, as used with an opcode. If no 
argument is specified, is assumed. 

Example 

Macro Definition; 



THE FOLLOWING MACRO IS USED TO PUSH AN ADDRESS ON THE STACK. IT CHECKS 
THE OPERAND TYPE (BY USING .NTYPE) TO DETERMINE IF THE OPERAND IS AN 
ADDRESS AND, IF NOT, THE MACRO SIMPLY PUSHES THE ARGUMENT ON THE STACK 
AND GENERATES A WARNING MESSAGE. 



.MACRO PUSHADR ADDR 

.NTYPE A, ADDR 
A = A@-4&~XF 

.IF IDENTICAL 0,<ADDR> 

PUSHL #0 

•MEXIT 

.ENDC 
ERR = 

,IIF LESS EQUAL A-l, ERR=1 



ASSIGNS OPERAND TYPE TO A 
ISOLATE ADDRESSING MODE 
IS ARGUMENT EXACTLY 
STACK ZERO 
EXIT FROM MACRO 

ERR TELLS IF MODE IS ADDRESS 
ERR = FOR ADDRESS, 1 WHEN NOT 
IS MODE NOT LITERAL OR IMMEDIATE 
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IS MODE NOT REGISTER 

IS MODE ADDRESS? 

YES, STACK ADDRESS 

NO 

THEN STACK OPERAND & WARN 



MACROS 

. IIF EQUAL A-5, ERR=1 

•IF EQUAL ERR 

PUSHAL ADDR 

.IFF 

PUSHL ADDR 

.WARN ; ADDR IS NOT AN ADDRESS 

.ENDC 

. ENDM PUSHADR 

Macro calls and expansions of the macro defined above: 

1. PUSHADR (RO) ; VALID ARGUMENT 
PUSHAL (RO) ; YES, STACK ADDRESS 

2. PUSHADR (Rl) [R4] ; VALID ARGUMENT 
PUSHAL (Rl) [R4] ; YES, STACK ADDRESS 

3. PUSHADR ; IS ZERO 
PUSHL #0 ; STACK ZERO 

4. PUSHADR #1 ; NOT AN ADDRESS 

PUSHL #1 ; THEN STACK OPERAND & WARN 

%MACRO-W-GENWRN, Generated WARNING: #1 IS NOT AN ADDRESS 

5. PUSHADR RO ; NOT AN ADDRESS 

PUSHL RO ; THEN STACK OPERAND & WARN 

%MACRO-W-GENWRN, Generated WARNING: RO IS NOT AN ADDRESS 

Note that to save space, this example is listed as it would appear if 
.SHOW BINARY, not .SHOW EXPANSIONS, was specified in the source 
program. 
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.REPEAT 



.REPEAT — REPEAT BLOCK DIRECTIVE 

•REPEAT repeats a block of code, a specified number of times, inline 
with other source code. The .ENDR directive specifies the end of the 
range. 



Format 



range 

,ENDR 
Parameters 



REPEAT expression 



expression 



An expression whose value controls the number of times the range 
is to be assembled within the program. When the expression is 
less than or equal to 0, the repeat block is not assembled. The 
expression must not contain any undefined symbols and must be an 
absolute expression (see Section 3.5) . 



range 

The source text to be repeated the number of times specified by 
the value of the expression. The repeat block can contain macro 
definitions, indefinite repeat blocks, or other repeat blocks. 
.MEXIT is legal within the range. 

Example 

Macro definition: 

.MACRO COPIES STRING, NUM 

.REPEAT NUM 

.ASCII /STRING/ 

.ENDR 

.BYTE 

.ENDM COPIES 

Macro calls and expansions of the macro defined above: 

1. 



COPIES 


<ABCDEF>,5 


.REPEAT 


5 


.ASCII 


/ABCDEF/ 


.ENDR 




.ASCII 


/ABCDEF/ 


.ASCII 


/ABCDEF/ 


.ASCII 


/ABCDEF/ 


.ASCII 


/ABCDEF/ 


.ASCII 


/ABCDEF/ 


.BYTE 
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2. 



VARB = 3 



COPIES <HOW MANY TIMES>,\VARB 

•REPEAT 3 

.ASCII /HOW MANY TIMES/ 

.ENDR 

.ASCII /HOW MANY TIMES/ 

.ASCII /HOW MANY TIMES/ 

.ASCII /HOW MANY TIMES/ 

.BYTE 



The alternate form of .REPEAT is .REPT. 
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ASCII CHARACTER SET 



Table A-l lists the ASCII characters 
each. 



and the hexadecimal code for 



Table A-l 
Hexadecimal/ASCII Conversion 



HEX 


ASCII 


HEX 


ASCII 


HEX 


ASCII 


HEX 


ASCII 


Code 


Char. 


Code 


Char. 


Code 


Char. 


Code 


Char. 


00 


NUL 


20 


SP 


40 


§ 


60 


\ 


01 


SOH 


21 


! 


41 


A 


61 


a 


02 


STX 


22 


11 


42 


B 


62 


b 


03 


ETX 


23 


# 


43 


C 


63 


c 


04 


EOT 


24 


$ 


44 


D 


64 


d 


05 


ENQ 


25 


% 


45 


E 


65 


e 


06 


ACK 
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APPENDIX B 
VAX-11 MACRO ASSEMBLER DIRECTIVES AND LANGUAGE SUMMARY 

B.l ASSEMBLER DIRECTIVES 

The following table summarizes the VAX-11 MACRO assembler directives, 



Table B-l 
Assembler Directives 



Format 


Operation 


.ADDRESS address-list 


Stores successive longwords of 
address data 


• ALIGN keyword [, expression] 


Aligns the location counter to 
the boundary specified by the 
keyword 


.ALIGN integer [, expression] 


Aligns location counter to the 
boundary specified by (2~integer) 


.ASCIC string 


Stores the ASCII string string 
(enclosed in delimiters) , 
preceded by a count byte 


.ASCID string 


Stores the ASCII (enclosed in 
delimiters), preceded by a string 
descriptor 


.ASCII string 


Stores the ASCII string (enclosed 
in delimiters) 


•ASCIZ string 


Stores the ASCII string (enclosed 
in delimiters) followed by a 
byte. 


.BLKA expression 


Reserves longwords of address 
data 


•BLKB expression 


Reserves bytes for data 


.BLKD expression 


Reserves guadwords for 
double-precision, floating-point 
data 



(continued on next page) 
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Table B-l (Cont.) 
Assembler Directives 



Format 


Operation 


.BLKF expression 


Reserves longwords for 
single-precision, floating-point 
data 


. BLKL expression 


Reserves longwords for data 


.BLKQ expression 


Reserves quadwords for data 


.BLKW expression 


Reserves words for data 


•BYTE expression-list 


Generates successive bytes of 
data; each byte contains the 
value of the specified expression 


.CROSS 


Enables cross-referencing of all 
symbols 


.CROSS symbol -list 


Cross-references specified 
symbols 


•DEBUG symbol -list 


Makes symbol names known to the 
debugger 


.DEFAULT DISPLACEMENT, keyword 


Specifies the default 
displacement length for the 
relative addressing modes 


.DISABLE argument-list 


Disables function (s) specified in 
argument-list 


.DOUBLE literal-list 


Generates 8-byte, 
double-precision, floating-point 
data 


.DSABL argument-list 


Equivalent to .DISABLE 


•ENABL argument-list 


Equivalent to .ENABLE 


.ENABLE argument-list 


Enables function (s) specified in 
argument-list 


.END [symbol] 


Indicates logical end of source 
program; optional symbol 
specifies transfer address 


.ENDC 


Indicates end of conditional 
assembly block 


•ENDM [macro-name] 


Indicates end of macro definition 


• ENDR 


Indicates end of repeat block 


•ENTRY symbol [, expression] 


Procedure entry directive 



(continued on next page) 
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Table B-l (Cont.) 
Assembler Directives 



Format 


Operation 


•ERROR [expression] ;comment 


Displays specified error message 


• EVEN 


Ensures that the current location 
counter has an even value (adds 1 
if it is odd) 


.EXTERNAL symbol -list 


Indicates specified symbols are 
externally defined 


.EXTRN symbol -list 


Equivalent to .EXTERNAL 


.FLOAT literal-list 


Generates 4-byte, 
single-precision, floating point 
data 


.GLOBAL symbol -list 


Indicates specified symbols are 
global symbols 


. GLOBL 


Equivalent to .GLOBAL 


.IDENT string 


Provides means of labeling object 
module with additional data 


•IF condition argument (s) 


Begins a conditional assembly 
block of source code which is 
included in the assembly only if 
the stated condition is met with 
respect to the argument (s) 
specified 


• IFF 


Equivalent to .IF FALSE 


. IF_FALSE 


Appears only within a conditional 
assembly block; begins block of 
code to be assembled if the 
original condition tests false 


• IFT 


Equivalent to ,IF_TRUE 


• IFTF 


Equivalent to . IF_TRUE_FALSE 


. IF_TRUE 


Appears only within a conditional 
assembly block; begins block of 
code to be assembled if the 
original condition tests true 


. IF_TRUE_FALSE 


Appears only within a conditional 
assembly block; begins block of 
code to be assembled 
unconditionally 



(continued on next page) 
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Table B-l (Cont.) 
Assembler Directives 



Format 



Operation 



, IIF condition argument (s), 
statement 



. IRP symbol, <argument list> 

. IRPC symbol, <string> 

.LIBRARY macro-library-name 
.LIST [argument-list] 
.LONG expression-list 

.MACRO macro-name argument-list 
.MASK symbol [, expression] 

.MCALL macro-name-list 

.MDELETE macro-name-list 

.MEXIT 

.NARG symbol 

.NCHR symbol, <string> 

.NLIST [argument-list] 
.NOCROSS 



Acts as a 1-line conditional 
assembly block where the 
condition is tested for the 
argument specified; the 
statement is assembled only if 
the condition tests true 

Replaces a formal argument with 
successive actual arguments 
specified in an argument list 

Replaces a formal argument with 
successive single characters 
specified in string 

Specifies a macro library 

Equivalent to .SHOW 

Generates successive longwords of 
data; each longword contains the 
value of the specified 
expression. 

Begins a macro definition 

Reserves a word for and copies a 
register save mask 

Specifies the system and/or 
user-defined macros in libraries 
that are required to assemble the 
source program 

Deletes from memory the macro 
definitions of the macros in the 
list 

Exits from the expansion of a 
macro before the end of the macro 
is encountered 

Determines the number of 
arguments in the current macro 
call 

Determines the number of 
characters in a specified 
character string 

Equivalent to .NOSHOW 

Disables cross-referencing of all 
symbols 



(continued on next page) 



B-4 



VAX-11 MACRO ASSEMBLER DIRECTIVES AND LANGUAGE SDMMART 



Table B-l (Cont.) 
Assembler Directives 



Format 


Operation 


.NOCROSS symbol -list 


Disables cross-referencing of 
specified symbols 


.NOSHOW 


Decrements listing level count 


.NOSHOW argument-list 


Controls listing of macros and 
conditional assembly blocks 


.NTYPE symbol , operand 


Can appear only within a macro 
definition; equates the symbol 
to the addressing mode of the 
specified operand 


.ODD 


Ensures that the current location 
counter has an odd value (adds 1 
if it is even) 


.OPDEF opcode value, 
operand-descriptor -list 


Defines an opcode and its 
operand list 


.PACKED decimal -string [, symbol] 


Generates packed decimal data, 2 
digits per byte 


.PAGE 


Causes the assembly listing to 
skip to the top of the next page, 
and to increment the page count 


.PRINT [expression] ;comment 


Displays the specified message 


. PSECT 


Begins or resumes the blank 
program section 


•PSECT section-name 
argument-list 


Begins or resumes a user-defined 
program section 


.QUAD literal 


Stores 8-bytes of data 


•QUAD symbol 


Stores 8-bytes of data 


.REF1 operand 


Generates byte operand 


.REF2 operand 


Generates word operand 


.REF4 operand 


Generates longword operand 


.REF8 operand 


Generates quadword operand 


.REPEAT expression 


Begins a repeat block; the 
section of code up to the next 
. ENDR directive is repeated the 
number of times specified by the 
expression 


.REPT 


Equivalent to .REPEAT 



(continued on next page) 
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Table B-l (Cont.) 
Assembler Directives 



Format 


Operation 


. RESTORE 


Equivalent to . RESTORE_PSECT 


.RESTORE_PSECT 


Restores program section context 
from the program section context 
stack 


•SAVE [LOCAL_BLOCK] 


Equivalent to .SAVE_PSECT 


.SAVE_PSECT [LOCAL_BLOCK] 


Saves current program section 
context on the program section 
context stack 


.SBTTL comment-string 


Equivalent to .SUBTITLE 


.SHOW 


Increments listing level count 


.SHOW argument-list 


Controls listing of macros and 
conditional assembly blocks 


.SIGNED_BYTE expression-list 


Stores successive bytes (8 bits) 
of signed data 


.SIGNED_WORD expression-list 


Stores successive words (16 bits) 
of signed data 


.SUBTITLE comment-string 


Causes the specified string to be 
printed as part of the assembly 
listing page header; the string 
component of each .SUBTITLE is 
collected into a table of 
contents at the beginning of the 
assembly listing 


.TITLE module-name 

comment-str ing 


Assigns the first 15 characters in 
the string as an object module 
name and causes the string to 
appear on each page of the 
assembly listing 


.TRANSFER symbol 


Directs the linker to redefine 
the value of the global symbol 
for use in a shareable image 


•WARN [expression] ;comment 


Displays specified warning 
message 


.WEAK symbol -list 


Indicates that each of the listed 
symbols has the weak attribute 


.WORD expression-list 


Generates successive words of 
data; each word contains the 
value of the corresponding 
specified expression 
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B.2 SPECIAL CHARACTERS 

The following table summarizes the VAX-11 MACRO special characters. 



Table B-2 
Special Characters Used in VAX-11 MACRO Statements 



Character 



Character Name 



Function (s) 



/ 
& 

! 



Underline 
Dollar sign 
Period 

Colon 
Equal sign 

Tab 
Space 
Number sign 

At sign 

Comma 

Semicolon 
Plus sign 

Minus sign 

Asterisk 

Slash 

Ampersand 

Exclamation 
point 



Character in symbol names 

Character in symbol names 

Character in symbol names, 
current location counter, and 
decimal point 

Label terminator 

Direct assignment operator and 
macro keyword argument terminator 

Field terminator 

Field terminator 

Immediate addressing mode 
indicator 

Deferred addressing mode 
indicator and arithmetic shift 
operator 

Field, operand, and item 
separator 

Comment field indicator 

Autoincrement addressing mode 
indicator, unary plus operator, 
and arithmetic addition operator 

Autodecrement addressing mode 
indicator, unary minus operator, 
arithmetic subtraction operator, 
and line continuation indicator 

Arithmetic multiplication 
operator 

Arithmetic division operator 

Logical AND operator 

Logical inclusive OR operator 



(continued on next page) 
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Table B-2 (Cont.) 
Special Characters Used in VAX-11 MACRO Statements 



Character 


Character Name 


Function (s) 


\ 


Backslash 


Logical exclusive OR and numeric 
conversion indicator in macro 
arguments 


** 


Circumflex 


Unary operator indicator and 
macro argument delimiter 


[] 


Square brackets 


Index addressing mode and repeat 
count indicators 





Parentheses 


Register deferred addressing mode 
indicators 


<> 


Angle brackets 


Argument or expression grouping 
delimiters 


? 


Question mark 


Created label indicator in macro 
arguments 


■ 


Apostrophe 


Macro argument concatenation 
indicator 


% 


Percent sign 


Macro string operators 



B . 3 OPERATORS 



B.3.1 Unary Operators 

The following table summarizes the VAX-11 MACRO unary operators. 

Table B-3 
Unary Operators 



Unary 
Operator 


Operator 
Name 


Example 


Effect 


+ 


Plus sign 


+A 


Results in the positive 
value of A (default) 


- 


Minus sign 


-A 


Results in the negative 
(2's complement) value 
of A 


"B 


Binary 


"B11000111 


Specifies that 11000111 
is a binary number 



(continued on next page) 
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Unary 
Operator 



Table B-3 (Cont.) 
Unary Operators 



Operator 
Name 



Example 



Effect 



M 



Decimal 



Octal 



Hexadecimal 



ASCII 



Register mask 



Floating point 



Complement 



*D127 
"034 
*XFCF9 
* A/ABC/ 



*M<R3,R4,R5> 



'F3.0 



C24 



Specifies that 127 is a 
decimal number 

Specifies that 34 is an 
octal number 

Specifies that FCF9 is 
a hexadecimal number 

Produces an ASCII 
string; the characters 
between the matching 
delimiters are 
converted to ASCII 
representation 

Specifies the registers 
R3, R4, and R5 in the 
register mask 

Specifies that 3.0 is a 
floating-point number 

Produces the l's 
complement value of 24 
(decimal) 



B.3.2 Binary Operators 

The following table summarizes the VAX-11 MACRO binary operators, 



Table B-4 
Binary Operators 



Binary 
Operator 


Operator 
Name 


Example 


Operation 


+ 


Plus sign 


A+B 


Addition 


- 


Minus sign 


A-B 


Subtraction 


* 


Asterisk 


A*B 


Multiplication 


/ 


Slash 


A/B 


Division 


@ 


At sign 


A@B 


Arithmetic Shift 


& 


Ampersand 


A&B 


Logical AND 


i 


Exclamation point 


A!B 


Logical inclusive OR 


\ 


Backslash 


A\B 


Logical exclusive OR 
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B.3.3 Macro String Operators 

The following table summarizes the macro string operators, 
operators can be used only in macros. 



These 



Table B-5 
Macro String Operators 



Format 


Function 


%LENGTH (string) 

% LOCATE (string l,string2[, symbol] ) 

%EXTRACT ( symbol 1 , symbol 2 , str ing ) 


Returns the length of the 
string 

Locates the substring 
stringl within string2 
starting the search at the 
character position specified 
by symbol 

Extracts a substring from 
string that begins at 
character position specified 
by symbol 1 and has a length 
specified by symbol 2 



B.4 ADDRESSING MODES 

The following table summarises the VAX-11 MACRO addressing modes, 
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> APPENDIX C 
PERMANENT S7HB0L T* iLE 



The permanent symbol table (PST) contains the symbols that VAX-11 
MACRO automatically recognizes. These symbols consist of both opcodes 
and assembler directives. Sections C.l and C.2 below present the 
opcodes (instruction set) in alphabetical and numerical order, 
respectively. Appendix B (in Section B.l) presents the assembler 
directives. 



The VAX-11/780 Architecture Handbook provides a 
of the instruction set. 



detailed description 



C.l OPCODES (ALPHABETIC ORDER) 



Hexadecimal 
Value 

9D 
6F 
4F 
Fl 
3D 
58 
80 
81 

60 
61 
40 
41 
CO 
CI 
20 
21 

A0 
Al 
D8 
F3 
F2 
78 
F8 
79 
El 
E5 
E7 
E3 
E0 



Mnemonic 

ACBB 

ACBD 

ACBF 

ACBL 

ACBW 

ADAWI 

ADDB2 

ADDB3 

ADDD2 
ADDD3 
ADDF2 
ADDF3 
ADDL2 
ADDL3 
ADDP4 
ADDP6 

ADDW2 

ADDW3 

ADWC 

AOBLEQ 

AOBLSS 

ASHL 

ASHP 

ASHQ 

BBC 

BBCC 

BBCCI 

BBCS 

BBS 



Functional Name 



Add 
Add 
Add 
Add 
Add 
Add 
Add 
Add 



compare and branch float 
compare and branch long 
compare and branch word 
aligned word interlocked 
byte 2 operand 
byte 3 operand 



Add double 2 operand 
Add double 3 operand 
Add floating 2 operand 
Add floating 3 operand 
Add long 2 operand 
Add long 3 operand 
Add packed 4 operand 
Add packed 6 operand 

Add word 2 operand 

Add word 3 operand 

Add with carry 

Add one and branch on less or equal 

Add one and branch on less 

Arithmetic shift long 

Arithmetic shift and round packed 

Arithmetic shift quad 

Branch on bit clear 

Branch on bit clear and clear 

Branch on bit clear and clear interlocked 

Branch on bit clear and set 

Branch on bit set 



C-l 



PERMANENT SYMBOL TABLE 



Hexadec 


imal 


Value 


Mnemonic 


E4 


BBSC 


E2 


BBSS 


E6 


BBSSI 


IE 


BCC 


IF 


BCS 


13 


BEQL 


13 


BEQLU 


18 


BGEQ 


IE 


BGEQU 


14 


BGTR 


1A 


BGTRU 


8A 


BICB2 


8B 


BICB3 


CA 


BICL2 


CB 


BICL3 


B9 


BICPSW 


AA 


BICW2 


AB 


BICW3 


88 


BISB2 


89 


BISB3 


C8 


BISL2 


C9 


BISL3 


B8 


BISPSW 


A8 


BISW2 


A9 


BISW3 


93 


BITB 


D3 


BITL 


B3 


BITW 


E9 


BLBC 


E8 


BLBS 


15 


BLEQ 


IB 


BLEQU 


19 


BLSS 


IF 


BLSSU 


12 


BNEQ 


12 


BNEQU 


03 


BPT 


11 


BRB 


31 


BRW 


10 


BSBB 


30 


BSBW 


1C 


BVC 


ID 


BVS 


FA 


CALLG 


FB 


CALLS 


8F 


CASEB 


CF 


CAS EL 


AF 


CASEW 


BD 


CHME 


BC 


CHMK 


BE 


CHMS 


BF 


CHMU 


94 


CLRB 



Functional Name 

Branch on bit set and clear 

Branch on bit set and set 

Branch on bit set and set interlocked 

Branch on carry clear 

Branch on carry set 

Branch on equal 

Branch on equal unsigned 

Branch on greater or equal 

Branch on greater or equal unsigned 

Branch on greater 

Branch on greater unsigned 

Bit clear byte 2 operand 
Bit clear byte 3 operand 
Bit clear long 2 operand 
Bit clear long 3 operand 
Bit clear program status word 
Bit clear word 2 operand 
Bit clear word 3 operand 
Bit set byte 2 operand 

Bit set byte 3 operand 
Bit set long 2 operand 
Bit set long 3 operand 
Bit set program status word 
Bit set word 2 operand 
Bit set word 3 operand 
Bit test byte 
Bit test long 

Bit test word 

Branch on low bit clear 

Branch on low bit set 

Branch on less or equal 

Branch on less or equal unsigned 

Branch on less 

Branch on less unsigned 

Branch on not equal 

Branch on not equal unsigned 

Break point trap 

Branch with byte displacement 

Branch with word displacement 

Branch to subroutine with byte displacement 

Branch to subroutine with word displacement 

Branch on overflow clear 

Branch on overflow set 

Call with general argument list 

Call with stack 

Case byte 

Case long 

Case word 

Change mode to executive 

Change mode to kernel 

Change mode to supervisor 

Change mode to user 

Clear byte 
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PERMANENT SYMBOL TABLE 



Hexadecimal 
Value 

7C 
DF 
D4 
7C 
B4 
91 

29 
2D 
71 
51 
Dl 
35 
37 
EC 

Bl 
ED 
OB 
6C 
4C 
98 
99 
68 

76 
6A 
69 
48 
56 
4A 
49 
F6 

6E 
4E 
F9 
F7 
36 
08 
24 
6B 

4B 
09 
26 
33 
6D 
4D 
32 
97 

D7 
B7 
86 
87 
66 
67 
46 
47 



Mnemonic Functional Name 

CLRD Clear double 

CLRF Clear float 

CLRL Clear long 

CLRQ Clear quad 

CLRW Clear word 

CMPB Compare byte 

CMPC3 Compare character 3 operand 

CMPC5 Compare character 5 operand 

CMPD Compare double 

CMPF Compare floating 

CMPL Compare long 

CMPP3 Compare packed 3 operand 

CMPP4 Compare packed 4 operand 

CMPV Compare field 

CMPW Compare word 

CMPZV Compare zero-extended field 

CRC Calculate cyclic redundancy check 

CVTBD Convert byte to double 

CVTBF Convert byte to float 

CVTBL Convert byte to long 

CVTBW Convert byte to word 

CVTDB Convert double to byte 

CVTDF Convert double to float 

CVTDL Convert double to long 

CVTDW Convert double to word 

CVTFB Convert float to byte 

CVTFD Convert float to double 

CVTFL Convert float to long 

CVTFW Convert float to word 

CVTLB Convert long to byte 

CVTLD Convert long to double 

CVTLF Convert long to float 

CVTLP Convert long to packed 

CVTLW Convert long to word 

CVTPL Convert packed to long 

CVTPS Convert packed to leading separate 

CVTPT Convert packed to trailing 

CVTRDL Convert rounded double to long 

CVTRFL Convert rounded float to long 

CVTSP Convert leading separate to packed 

CVTTP Convert trailing to packed 

CVTWB Convert word to byte 

CVTWD Convert word to double 

CVTWF Convert word to float 

CVTWL Convert word to long 

DECB Decrement byte 

DECL Decrement long 

DECW Decrement word 

DIVB2 Divide byte 2 operand 

DIVB3 Divide byte 3 operand 

DIVD2 Divide double 2 operand 

DIVD3 Divide double 3 operand 

DIVF2 Divide floating 2 operand 

DIVF3 Divide floating 3 operand 
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PERMANENT SYMBOL TABLE 



Hexadecimal 




Value 


Mnemonic 


C6 


DIVL2 


C7 


DIVL3 


27 


DIVP 


A6 


DIVW2 


A7 


DIVW3 


38 


EDITPC 


7B 


EDIV 


74 


EMODD 


54 


EMODF 


7A 


EMUL 


EE 


EXTV 


EF 


EXTZV 


EB 


FFC 


EA 


FFS 


00 


HALT 


96 


INCB 


D6 


INCL 


B6 


INCW 


0A 


INDEX 


OE 


INSQUE 


FO 


INSV 


17 


JMP 


16 


JSB 


06 


LDPCTX 


3A 


LOCC 


39 


MATCHC 


92 


MCOMB 


D2 


MCOML 


B2 


MCOMW 


DB 


MFPR 


8E 


MNEGB 


72 


MNEGD 


52 


MNEGF 


CE 


MNEGL 


AE 


MNEGW 


9E 


MOVAB 


7E 


MOVAD 


DE 


MOVAF 


DE 


MOVAL 


7E 


MOVAQ 


3E 


MOVAW 


90 


MOVB 


28 


MOVC3 


2C 


MOVC5 


70 


MOVD 


50 


MOVF 


DO 


MOVL 


34 


MOVP 



Functional Name 

Divide long 2 operand 
Divide long 3 operand 
Divide packed 
Divide word 2 operand 
Divide word 3 operand 
Edit packed to character 
Extended divide 
Extended modulus double 

Extended modulus floating 

Extended multiply 

Extract field 

Extract zero-extended field 

Find first clear bit 

Find first set bit 

Halt 

increment byte 

Increment long 
Increment word 
Index calculation 
Insert into queue 
Insert field 
Jump 

Jump to subroutine 
Load program context 

Locate character 

Match characters 

Move complemented byte 

Move complemented long 

Move complemented word 

Move from processor register 

Move negated byte 

Move negated double 



Move 


negated floating 


Move 


negated long 


Move 


negated word 


Move 


address of byte 


Move 


address of double 


Move 


address of float 


Move 


address of long 


Move 


address of quad 


Move 


address of word 


Move 


byte 


Move 


character 3 operand 


Move 


character 5. operand 


Move 


double 


Move 


float 


Move 


long 


Move 


packed 
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PERMANENT SYMBOL TABLE 



Hexadecimal 




Value 


Mnemonic 


DC 


MOVPSL 


7D 


MOVQ 


2E 


MOVTC 


2F 


MOVTUC 


BO 


MOVW 


OA 


MOVZBL 


9B 


MOVZBW 


3C 


MOVZWL 


DA 


MTPR 


84 


MOLB2 


85 


MULB3 


64 


MULD2 


65 


MULD3 


44 


MULF2 


45 


MULF3 


C4 


MULL2 


C5 


MULL3 


25 


MULP 


A4 


MULW2 


A5 


MULW3 


01 


NOP 


75 


POLYD 


55 


POLYF 


BA 


POPR 


OC 


PROBER 


OD 


PROBEW 


9F 


PUSHAB 


7F 


PUS HAD 


DF 


POSHAF 


DF 


PUSHAL 


7F 


PUSHAQ 


3F 


PUS HAW 


DD 


PUSHL 


BB 


PUSHR 


02 


RE I 


OF 


REMQUE 


04 


RET 


9C 


ROTL 


05 


RSB 


D9 


SBWC 


2A 


SCANC 


3B 


SKPC 


F4 


SOBGEQ 


F5 


SOBGTR 


2B 


SPANC 


82 


SUBB2 


83 


SUBB3 


62 


SUBD2 


63 


SUBD3 


42 


SUBF2 


43 


SUBF3 


€2 


SUBL2 


C3 


SUBL3 


22 


SUBP4 


23 


SUBP6 



Functional Name 

Move program status longword 

Move quad 

Move translated characters 

Move translated until character 

Move word 

Move zero-extended byte to long 

Move zero-extended byte to word 

Move zero-extended word to long 

Move to processor register 
Multiply byte 2 operand 
Multiply byte 3 operand 
Multiply double 2 operand 
Multiply double 3 operand 
Multiply floating 2 operand 
Multiply floating 3 operand 
Multiply long 2 operand 

Multiply long 3 operand 
Multiply packed 
Multiply word 2 operand 
Multiply word 3 operand 
No operation 

Evaluate polynomial double 
Evaluate polynomial floating 
Pop registers 

Probe read access 
Probe write access 
Push address of byte 
Push address of double 
Push address of float 
Push address of long 
Push address of quad 
Push address of word 

Push long 

Push registers 

Return from exception or interrupt 

Remove from queue 

Return from called procedure 

Rotate long 

Return from subroutine 

Subtract with carry 

Scan for character 

Skip character 

Subtract one and branch on greater or equal 

Subtract one and branch on greater 

Span characters 

Subtract byte 2 operand 

Subtract byte 3 operand 

Subtract double 2 operand 

Subtract double 3 operand 
Subtract floating 2 operand 
Subtract floating 3 operand 
Subtract long 2 operand 
Subtract long 3 operand 
Subtract packed 4 operand 
Subtract packed 6 operand 
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Hexadecimal 

Value Mnemonic Functional Name 

Subtract word 2 operand 

Subtract word 3 operand 

Save process context 

Test byte 

Test double 

Test float 

Test long 

Test word 

Extended function call 

Exclusive-OR byte 2 operand 
Exclusive-OR byte 3 operand 
Exclusive-OR long 2 operand 
Exclusive-OR long 3 operand 
Exclusive-OR word 2 operand 
Exclusive-OR word 3 operand 
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SUBW2 


A3 


SUBW3 
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SVPCTX 


95 


TSTB 


73 


TSTD 


53 


TSTF 
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TSTL 


B5 


TSTW 


FC 


XFC 


8C 


XORB2 


8D 


XORB3 


CC 


XORL2 


CD 


XORL3 


AC 


XORW2 


AD 


XORW3 
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APPENDIX D 
HEXADECIMAL/DECIMAL CONVERSION 



Table D-l lists the decimal value for each possible hexadecimal value 
in each byte of a longword. The following sections contain 
instructions to use the table to convert hexadecimal numbers to 
decimal and vice versa. 



D.l HEXADECIMAL TO DECIMAL 

For each integer position of the hexadecimal value, locate the 
corresponding column integer and record its decimal equivalent in the 
conversion table. Add the decimal equivalent to obtain the decimal 
value. 

For example: 

D0500AD0 (16) = ?(10) 

D0000000 = 3,489,660,928 

500000 = 5,242,880 

A00 = 2,560 

DO = 208 



D0500AD0 = 3,494,904,576 



D.2 DECIMAL TO HEXADECIMAL 



Step 1: locate in the conversion table the largest decimal value that 
does not exceed the decimal number to be converted. Step 2: record 
the hexadecimal equivalent followed by the number of 0s that 
corresponds to the integer column minus 1. Step 3: subtract the 
table decimal value from the decimal number to be converted. Step 4: 
repeat steps 1 through 3 until the subtraction balance equals 0. Add 
the hexadecimal equivalents to obtain the hexadecimal value. 
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Example: 

22,466 

20,480 

1,792 

192 

2 


(10) 


= 


?(16) 

5000 

700 

CO 

2 


22,466 
-20,480 


1,986 
- 1,792 


22,466 


57C2 


194 
192 




2 
2 



D.3 POWERS OF 2 AND 16 

This section lists the decimal values of powers of 2 and 16. These 
values are often useful in converting decimal numbers to hexadecimal. 



Powers o 


f 2 


Powers of 16 




2**n 


n 


16**n 


n 


256 


8 


1 





512 


9 


16 


1 


1024 


10 


256 


2 


2048 


11 


4096 


3 


4096 


12 


65536 


4 


8192 


13 


1048576 


5 


16384 


14 


16777216 


6 


32768 


15 


268435456 


7 


65536 


16 


4294967296 


8 


131072 


17 


68719476736 


9 


262144 


18 


1099511627776 


10 


524288 


19 


17592186044416 


11 


1048576 


20 


281474976710656 


12 


2097152 


21 


4503599627370496 


13 


4194304 


22 


72057594037927936 


14 


8388608 


23 


1152921504606846976 


15 


16777216 


24 
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INDEX 



~A operator, 3-12, 3-13 
Absolute, 

index mode, 4-15, 4-16 
mode, 4-13, 4-14 
program sections, 5-45 
Accuracy of floating-point 

numbers, 3-4 
Addition, 3-15 
Address data, 

initializing memory with, 5-3 
reserving memory for, 5-9 
.ADDRESS directive, 5-3 
Address, starting, 5-21, 5-22 
Address, transfer, 5-21, 5-22 
Addressing modes, 2-3, 4-1 
through 4-18 
summary of, 4-2 through 4-5, 
B-ll through B-14 
.ALIGN directive, 5-4, 5-5 
Alignment, 

data, 5-4, 5-5 

location counter, 5-4, 5-5 

5-25, 5-39 
program section, 5-45, 5-48 
AMA attribute, 5-18 
AND operator, 3-16 
AP register, 3-5 
Argument , 

concatenation in macros, 6-6 
macro, 6-1 through 6-8 
pointer, 3-5 
Arithmetic shift, 
operator, 3-16 
Arithmetic trap enable, 3-13, 3-14 
.ASCIC directive, 5-7 
•ASCID directive, 5-8 
ASCII, 

character set, A-l 
hexadecimal conversion, A-l 
operator, 3-12, 3-14 
strings, 3-12, 3-13, 5-6 
string storage, 5-6 through 5-8 
.ASCIx storage directives, 5-6 

through 5-8 
.ASCIZ directive, 5-8 
Assembler directives, 2-3, 5-1 
through 5-65, 6-1 through 
6-29 
summary of, 5-1, 5-2, 6-2, 
B-l through B-6 
Assembler functions, 5-18 through 

5-20 
Assigning a value, 3-17 
Assignment statements, 3-17, 
3-18 



Attributes, program section, 

5-44 through 5-48 
Autodecrement index mode, 4-15 

4-16 
Autodecrement mode, 4-8 
Autoincrement deferred index mode, 

4-15, 4-16 
Autoincrement deferred mode, 4-7, 

4-8 
Autoincrement index mode, 4-15, 

4-16 
Autoincrement mode, 4-6, 4-7 



B 

B~ displacement specifier, 

4-8 through 4-10, 4-12, 4-13 
A B unary operator, 3-11, 3-12 
Base mode, 4-15, 4-16 
Binary operators, 3-15 through 

3-17, B-9 
Binary radix, 3-12 
Blank lines, 2-2 
.BLKA directive, 5-9 
.BLKB directive, 5-9 
•BLKD directive, 5-9 
•BLKF directive, 5-9 
.BLKL directive, 5-9 
.BLKQ directive, 5-9 
.BLKW directive, 5-9 
•BLKx directive, 5-9 
Block labels, 3-7, 3-8 
Block storage directives, 5-9 
Branch instruction, 4-18 
Byte data, 

initializing memory with, 5-11, 
5-56 

reserving memory for, 5-9 
•BYTE directive, 5-11 



"C operator, 3-15 
Call instruction, 5-22, 5-23 
Changes from VAX-11 MACRO VI. Q, ix 
Character , 

indefinite repeat block, 6-16, 
6-17 

separating, 3-3 

set, 3-1, 3-2 

set, ASCII, A-l 

special, 3-1 3-2, B-7, B-8 

strings, 3-12, 3-13, 5-6 
Characters, counting, 6-9, 6-25 
Combining arguments in macros, 6-6 
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INDEX 



Comment field, 2-1, 2-4 
Complement operator, 3-15 
Concatenated program sections, 

5-46 
Concatenating arguments in 

macros , 6-6 
Conditional assembly blocks, 

5-29 through 5-35 
controlling listing of, 5-54, 

5-55 
one line block, 5-35 
subconditionals , 5-32 through 

5-34 
Condition tests, 5-30 
Continuation lines, 2-2 
Continuing program sections, 5-44 
Controlling listings, 5-54, 5-55 
Counted ASCII string storage, 

5-7 
Counter, current location, 3-18 
Counting characters, 6-9, 6-25 
Counting macro arguments, 6-24 
Counts, repeat, 3-10, 5-11, 5-37, 

5-56, 5-57, 5-65 
.CROSS directive, 5-13, 5-14 
Cross reference listing, 5-13, 

5-14 
Current location counter, 3-18 



"D unary operator, 3-11, 3-12 
Data alignment, 5-4, 5-5 
Data, reserving memory for, 5-9 
Data, initializing memory with, 

address, 5-3 

ASCII, 5-6 through 5-8 

byte, 5-11, 5-56 

double-precision, 5-17 

floating-point, 5-26 

longword, 5-37 

packed decimal, 5-42 

quadword , 5-49 

signed, 5-56, 5-57 

word, 5-57, 5-65 
DBG attribute, 5-18 
.DEBUG directive, 5-15 
Debugging information, 5-15, 5-18 
Decimal/hexadecimal conversion, 

lD-1 l through D-4 
Decimal radix, 3-11, 3-12 
Decimal strings, 3-4, 3-5, 5-42 
.DEFAULT directive, 5-16 
Default program sections, 5-44, 

5-48 
Default radix, 3-11 



Default values of macro 

arguments, 6-3 
Deferred mode, 

autoincrement , 4-7 
displacement, 4-9, 4-10 
register, 4-6 
relative, 4-13 
Defining, 

labels, 2-2 
macros, 6-19, 6-20 
opcodes, 5-40, 5-41 
Degree of precision, 3-4 
Deleting a macro, 6-22 
Delimited ASCII strings, 5-6 
Delimiters in macro arguments, 

6-4 through 6-6 
Descriptors, string, 5-8 
Direct assignment statements, 

3-17, 3-18 
Directives, 2-3, 3-5, 5-1 

through 5-65, 6-1 through 
6-29 
.DISABLE directive, 5-16, 5-18 
through 5-20 
LOCAL_BLOCK attribute, 3-8 
Disabling assembler functions, 

5-16, 5-18 through 5-20 
Displacement, 

controlling default, 5-16 
deferred index mode, 4-15, 4-16 
deferred mode, 4-9, 4-10 
index mode, 4-15, 4-16 
mode, 4-8, 4-9 
specifier, 4-8 through 4-10, 
4-12, 4-13 
Division, 3-15 
Documenting a program, 2-4 
•DOUBLE directive, 5-17 
Double precision, 3-4, 5-17 
Double-precision data, 

initializing memory with, 5-17 
reserving memory for, 5-9 
.DSABL directive, 5-16, 5-18 

through 5-20 
DV arithmetic trap enable, 3-14 



•ENABL directive, 5-18 through 

5-20 
.ENABLE directive, 5-18 through 

5-20 
LOCAL_BLOCK attribute, 3-8 
Enabling assembler functions, 5-18 

through 5-20 
.END directive, 5-21 
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• ENDC directive, 5-21, 5-29 

through 5-31 
Ending, 

conditional assembly blocks, 

5-21, 5-29 through 5-31 
macro definitions, 6-13, 6-19, 

6-20 
modules, 5-21 
repeat range definitions, 6-13, 

6-14 through 6-16 

• ENDM directive, 6-13, 6-19, 6-20 
.ENDR directive, 6-13 through 6-16 
.ENTRY directive, 5-22, 5-23 
Entry mask, 3-13, 3-14, 5-22, 5-23, 

5-38 
.ERROR directive, 5-24 
Exclusive OR operator, 3-17 
Executable program sections, 

5-44 through 5-46 
Expanding a macro, 6-1, 6-2 
Exponent, 3-4 
Expressions, 3-9, 3-10 
evaluation of, 3-9 
floating point, 3-14 
restrictions on, 3-10 
.EXTERNAL directive, 5-25 
External symbols, 3-7, 5-25, 5-27, 

5-64 
%EXTRACT macro string operator, 

6-11 
•EXTRN directive, 5-25 
•EVEN directive, 5-25 
Exiting a macro, 6-13, 6-19, 6-20 



*F operator, 3-14, 3-15 
Factors, repetition, 3-10, 5-11, 

5-37, 5-56, 5-57, 5-65 
Field, 

comment, 2-1, 2-4 

label, 2-1 through 2-3 

operand, 2-1, 2-3, 2-4 

operator, 2-1, 2-3 
•FLOAT directive, 5-25 
Floating-point data, 

initializing memory with, 5-17, 
5-26 

reserving memory for, 5-9 
Floating-point expressions, 3-14 
Floating-point numbers, 3-3, 
3-4, 3-14, 3-15 

format of, 3-4 

rounding of, 5-18, 5-19 

truncation of, 5-18, 5-19 
Floating-point operator, 3-15 
Floating-point short literals, 
4-11 



Format, statement, 2-1 through 

2-4 
Formatting with tabs, 2-1, 2-2 
FP register, 3-5, 3-14 
FPT attribute, 5-18, 5-19 
Frame pointer, 3-5 
Functions, assembler, 5-18 through 

5-20 



GBL attribute, 5-18, 5-19 
General mode, 4-15 
General registers, 3-5 
General register modes, 4-1 

through 4-12 
•GLOBAL directive, 5-27 
Global program sections, 5-46 
Global symbols, 2-2, 3-7, 3-17, 
5-18, 5-19, 5-25, 5-27, 5-64 

defining, 2-2 

weak, 5-64 
.GLOBL directive, 5-27 



H 

Hexadecimal/ASCII conversion, A-l 
Hexadecimal/decimal conversion, 

D-l through D-4 
Hexadecimal radix, 3-12 



I 

I* addressing mode, 4-14, 4-15 
.IDENT directive, 5-28 
Identifying a module, 5-28, 5-60 
.IF directive, 5-29 through 5-31 
•IF_FALSE directive, 5-32 through 

5-34 
.IF_TRUE directive, 5-32 through 

5-34 
. IF_TRUE_FALSE directive, 5-32 

through 5-34 
•IFF directive, 5-32 through 5-34 
•IFT directive, 5-32 through 5-34 
•IFTF directive, 5-32 through 5-34 
•IFx directives, 5-32 through 5-34 
•IIF directive, 5-35 
Immediate conditional block, 5-35 
Immediate mode, 4-14 
Inclusive OR operator, 3-17 
Indefinite repeat blocks, 6-14, 

6-15 
Indefinite repeat character blocks, 

6-16, 6-17 
Index mode, 4-15 through 4-18 
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Initializing memory with, 

address data, 5-3 

ASCII data, 5-6 through 5-8 

byte data, 5-11, 5-56 

floating-point data, 5-17, 
5-26 

longword data, 5-37 

packed data, 5-42 

quad word data, 5-49 

word data, 5-57, 5-65 
Instructions, 1-1, 2-3, 3-5, 
C-l through C-8 

redefining, 5-40, 6-20 
Integer expressions, 3-9, 3-10 
Integers, 3-3 

Internal symbols, 2-2, 3-7, 3-17 
.IRP directive, 6-14, 6-15 
.IRPC directive, 6-16, 6-17 
IV arithmetic trap enable, 3-14 



K 

Keyword arguments in macros, 6-3, 
6-4 



L" displacement specifier, 4-8 

through 4-10, 4-12, 4-13 
Label , 

defining a, 2-2 

field, 2-1, 2-2 

local, 3-7, 3-8 

names, 2-2 

terminator, 2-2 
%LENGTH macro string operator, 6-9 
Length of source line, 2-1 
Lexical operators, 6-8 through 6-12 
.LIBRARY directive, 6-18 
Lines, continuation, 2-2 
.LIST directive, 5-36, 5-54, 5-55 
Listing, 

control of, 5-42, 5-54, 5-55 

cross reference, 5-13, 5-14 

table of contents, 5-59 
Literal mode, 4-10 through 4-12 
Literals, short, 4-10 through 4-12 
Local label block, 

delimiters, 3-8 

disabling, 3-8, 5-18, 5-19 

enabling, 3-8, 5-18, 5-19 

restoring, 5-51 

saving, 5-52 
Local labels, 3-7, 3-8, 5-18, 
5-19 

created, 6-7, 6-8 



Local program sections, 5-46 

%LOCATE macro string operator, 
6-10, 6-11 

Location counter, 3-18 

alignment, 5-4, 5-5, 5-28, 5-35 

Logical AND operator, 3-16 

Logical exclusive OR operator, 
3-17 

Logical inclusive OR operator, 
3-16 

.LONG directive, 5-37 

Longword data, 

initializing memory with, 5-37 
reserving memory for, 5-9 

LSB attribute, 3-8, 5-19 

M 

~M operator, 3-13, 3-14 
Machine instructions, 1-1 
.MACRO directive, 6-19, 6-20 
Macros, 6-1 through 6-29 

arguments in, 6-1 through 6-8 

calls to, 2-3 

controlling listing of, 5-54, 

5-55 
definitions of, 6-19, 6-20 
deletion of, 6-22 
exiting from, 6-23 
expand ing , 6 - 1 , 6-2 
libraries containing, 6-18 
maximum line size, 2-2 
names of, 3-6, 6-13, 6-19, 6-20 
redefining, 6-19, 6-20 
string operators in, 6-8 through 
6-12 
.MASK directive, 5-22, 5-38 
Mask, register save, 3-13, 3-14, 

5-22, 5-38 
•MCALL directive, 6-21 
.MDELETE directive, 6-22 
Messages, printing assembly, 5-24, 

5-43, 5-63 
.MEXIT directive, 6-23 
Mnemonic instructions, 3-5, C-l 

through C-8 
Modes, addressing, 2-3, 4-1 
through 4-18 
summary of, 4-2 through 4-5, 
B-ll through B-14 
Module, identifying, 5-28, 5-60 
Multiplication, 3-15 
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Names, 

macro, 3-6, 6-13, 6-19, 6-20 
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Names (Cont. ) 
module, 5-60 
register, 3-5 
symbol, 3-6 
.NARG directive, 6-24 
.NCHR directive, 6-25 
Negative numbers, 3-3 
.NLIST directive, 5-38, 5-54, 

5-55 
.NOCROSS directive, 5-13, 5-14, 

5-39 
•NOSHOW directive, 5-39, 5-54, 

5-55 
.NTYPE directive, 6-26 
Number of macro arguments, 6-1, 

6-24 
Numbers , 3-3 

floating point, 3-3, 3-4, 3-14, 

3-15, 5-17, 5-26 
integer, 3-3 

packed decimal, 3-4, 3-5, 5-42 
Numeric control operators, 3-14, 
3-15 



Passing numeric values in macros, 

6-7 
PC register, 3-5 
Permanent symbols, 3-5, C-l 
Position-independent code, 5-46, 

5-47 
Precision of floating-point 

numbers, 3-4 
.PRINT directive, 5-43 
Printing assembly messages, 5-24, 

5-43, 5-63 
Program counter, 3-5 
Program counter modes, 4-12 

through 4-15 
Program sections, 5-44 through 

5-48 



.QUAD directive, 5-49 

Quadword data, 

initializing memory with, 5-49 
reserving memory for, 5-9 



^O unary operator, 3-11, 3-12 
Octal radix, 3-11, 3-12 
.ODD directive, 5-39 
Opcodes, C-l through C-8 

defining, 5-40, 5-41 

redefining, 5-40, 6-20 
.OPDEF directive, 5-40, 5-41 
Operand , 

field, 2-1, 2-3 

generation directives, 5-50 

types, 6-26 
Operator , 

binary, 3-15 through 3-17, B-9 

field, 2-1, 2-3 

macro string, 6-8 through 6-12 

unary, 3-10 through 3-15, B-8, 
B-9 
OR operators, 3-17 
Overlaid program sections, 5-46 



Packed decimal strings, 3-4, 3-5, 

5-42 
.PACKED directive, 5-42 
.PAGE directive, 5-42 
Page ejection, 5-42 



Radix control, 3-11, 3-12 

Radix default, 3-11 

Radix operators, 3-11, 3-12 

in macro arguments, 6-5 
Real numbers, 3-3, 3-4 
Redefining, 

instructions, 5-40, 6-20 

macros, 6-19, 6-20 

opcodes, 5-40, 6-20 
.REFn directive, 5-50 
Register, 

deferred index mode, 4-15, 4-16 

deferred mode, 4-6 

mask operator, 3-13, 3-14 

mode, 4-6 

names, 3-5 

save mask, 3-13, 3-14, 5-22, 
5-38 
Relative, 

default displacement, 5-16 

deferred index mode, 4-15, 4-16 

deferred mode, 4-13 

index mode, 4-15, 4-16 

mode, 4-12, 4-13 
Relocatable program sections, 5-47 
Repeat blocks, 6-28, 6-29 

character, indefinite repeat, 
6-16, 6-17 

controlling listing of, 5-54, 5-55 
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Repeat blocks (Cont.) 

indefinite, 6-14, 6-15 
Repeat counts, 3-10, 5-11, 5-37, 

5-56, 5-57, 5-65 
.REPEAT directive, 6-28, 6-29 
Repeating a block of code, 6-28, 

6-29 
Repetition factors, 3-10, 5-11, 

5-37, 5-56, 5-57, 5-65 
• REPT directive, 6-28, 6-29 
•RESTORE directive, 5-51 
. RESTORE_PSECT directive, 5-51 
Restoring a program section, 

5-51 
Reserved bits in entry mask, 3-14, 

5-22 
Reserving storage, 5-9 
Rounding floating-point numbers, 

5-18, 5-19 



S" addressing mode, 4-10 through 

4-12 
.SAVE directive, 5-52 
.SAVE_PSECT directive, 5-52 
Saving a program section, 5-52 
Saving local label block, 5-52 
.SBTTL directive, 5-59 
Sections, program, 5-44 

through 5-48 
Separating characters, 3-3 
Shareable images, 5-61, 5-62 
Shareable program sections, 5-47 
Shift operator, arithmetic, 3-16 
Short literals, 4-10 through 4-12 
.SHOW directive, 5-54, 5-55 
.SIGNED_BYTE directive, 5-56 
Signed data storage, 5-56 through 

5-58 
.SIGNED_WORD directive, 5-57, 5-58 
Single precision, 3-4, 5-26 
Single-precision data, 

initializing memory with, 5-26 

reserving memory for, 5-9 
Source lines, 

blank, 2-2 

continuing, 2-2 

format of, 2-1 

length of, 2-1 
SP register, 3-5 
Special characters, 3-1, 3-2, 

B-7, B-8 
Stack pointer, 3-5 
Starting address, 5-21, 5-22 
Statement format, 2-1 through 2-4 



Storage, reserving, 5-9 

ASCII, 5-6 through 5-8 

block, 5-9 
Storing, 

address, 5-3 

ASCII, 5-6 through 5-8 

byte, 5-11, 5-56 

double-precision, 5-17 

floating-point, 5-26 

longword, 5-37 

packed decimal, 5-42 

signed, 5-56, 5-57 

quadword , 5-49 

word, 5-57, 5-65 
String, 

arguments in macros, 6-4 through 
6-6 

ASCII, 3-12, 3-13, 5-6 

descriptors, 5-8 

operators, 6-8 through 6-12 

packed decimal, 3-4, 3-5, 5-42 
Subconditional assembly blocks, 

5-29 through 5-31 
.SUBTITLE directive, 5-59 
Subtraction, 3-15 
Suppressing symbol table listing, 

5-18, 5-19 
Symbols, 3-5, 3-17 

external, 3-7, 5-25, 5-27, 5-64 

global, 2-2, 3-7, 3-17, 5-18 
through 5-20, 5-25, 5-27, 5-64 

internal, 3-7 

names of, 3-6 

permanent, 3-5, C-l 

undefined, 5-18, 5-19 

user-defined, 2-2, 3-6 



Tab formatting, 2-1, 2-2 
Table of contents, listing, 5-59 
TBK attribute, 5-19 
Technical changes from VAX-11 

MACRO VI. 0, ix 
Temporary labels, 3-7, 3-8 
Terms, 3-9 

Testing conditions, 5-30 
Textual operators, 3-12 through 3-14 
.TITLE directive, 5-60 
Traceback information, 5-19 
.TRANSFER directive, 5-61, 5-62 
Trap enable, arithmetic, 3-13, 

3-14 
Truncating floating-point number, 

5-18, 5-19 
Type of operand in macros, 6-24 



Index-6 



INDEX 



u 

Unary operators, 3-10 through 
3-15, B-8, B-9 

in macro arguments, 6-5 

summary of, 3-11, B-8, B-9 
Undefined symbols, 5-18, 5-19 
User-defined program sections, 

5-44 through 5-48 
User-defined symbol, 2-2 
User-generated , 

errors, 5-24 

messages, 5-43 

opcodes, 5-40, 5-41 

operands, 5-50 

warnings, 5-63 



w 

W" displacement specifier, 4-7, 
4-8 through 4-10, 4-12, 4-13 

•WARN directive, 5-63 

Warning directive, 5-63 

.WEAK directive, 5-64 

Weak symbols, 5-64 

Word data, 

initializing memory with, 5-57, 

5-65 
reserving memory for, 5-9 

.WORD directive, 5-65 

Write protecting program sections, 
5-44, 5-46 



V X unary operator, 3-12 



Value, passing arguments by, 6-7 
Vector, transfer, 5-61, 5-62 
Version number, 5-28 



Zero terminated ASCII string, 
5-8 
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NOTE: This form is for document comments only. DIGITAL will 
use comments submitted on this form at the company's 
discretion. If you require a written reply and are 
eligible to receive one under Software Performance 
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Did you find this manual understandable, usable, and well-organized? 
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Did you find errors in this manual? If so, specify the error and the 
page number. 
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